D&D知识导航器

基于Python的服务器，实现了模型上下文协议（MCP），连接Claude和其他AI助手到《龙与地下城》第五版游戏信息。

什么是MCP？

模型上下文协议（MCP）是由Anthropic开发的一个框架，使像Claude这样的AI助手能够与外部工具和服务进行通信。此服务器利用FastMCP，即Anthropic的Python实现的协议，创建了一个结构化的桥梁，连接AI助手与D&D 5e API。

对于MCP及其在本项目中的实现的详细解释，请参阅我们的博客文章。

特性

• FastMCP集成：提供给AI助手查询D&D游戏数据的工具和资源
• D&D 5e API集成：完全访问法术、怪物、装备、职业、种族等
• 高效缓存：持久本地存储API响应以提高性能
• 结构化数据访问：定义良好的资源和工具，确保一致的AI交互
• 来源归属：全面跟踪并显示信息来源
• 视觉格式化：Markdown模板用于美观地展示D&D内容
• 查询增强：智能处理D&D查询，包括同义词处理和模糊匹配

安装

预备条件

• Python 3.10或更高版本
• uv 包管理器（推荐）
• Claude桌面客户端（如需与Claude配合使用）

安装步骤

1. 克隆此仓库：

   git clone https://github.com/yourusername/dnd-knowledge-navigator.git
   cd dnd-knowledge-navigator
   

2. 安装依赖项：

   uv pip install -r requirements.txt
   

   或者

   pip install .
   

3. 配置Claude桌面客户端（如需与Claude配合使用）：

   • 在您的Claude桌面配置目录中创建一个claude_desktop_config.json文件
   • 添加以下配置（根据需要调整路径）：

     {
       "mcpServers": {
         "dnd": {
           "command": "/path/to/uv",
           "args": [
             "--directory",
             "/path/to/dnd-knowledge-navigator",
             "run",
             "dnd_mcp_server.py"
           ]
         }
       }
     }
     

4. 运行服务器：

   uv run python dnd_mc