D&D Knowledge Navigator
2025.03.15
1
Python游戏辅助AI集成娱乐功能
D&D Knowledge Navigator 是一个基于Python的服务器，实现了模型上下文协议（MCP），用于连接Claude和其他AI助手与《龙与地下城》5e游戏信息。该服务器通过FastMCP（Anthropic的Python实现）创建了一个结构化的桥梁，使AI助手能够查询D&D游戏数据。
View on GitHub
Overview
基本能力
产品定位
D&D Knowledge Navigator 是一个专为《龙与地下城》5e游戏设计的AI助手工具，旨在通过MCP协议提供游戏数据的查询和交互功能。
核心功能
- FastMCP集成：为AI助手提供查询D&D游戏数据的工具和资源。
- D&D 5e API集成：完整访问法术、怪物、装备、职业、种族等游戏数据。
- 高效缓存：本地持久化存储API响应以提高性能。
- 结构化数据访问：定义良好的资源和工具，确保一致的AI交互。
- 来源追踪：全面跟踪和显示信息源。
- 视觉格式化：使用Markdown模板美化D&D内容的展示。
- 查询增强：通过同义词处理和模糊匹配智能处理D&D查询。
适用场景
- 游戏玩家和DM（地下城主）快速查询游戏规则和数据。
- AI助手集成，提供游戏相关的智能问答服务。
- 游戏开发者和内容创作者获取结构化游戏数据。
工具列表
search_all_categories：在所有D&D资源中搜索特定术语。verify_with_api：验证D&D声明与官方API数据的一致性。check_api_health：检查D&D 5e API的健康状态。
常见问题解答
- 如何禁用模板系统？在
src/templates/config.py中设置TEMPLATES_ENABLED = False。 - 如何禁用查询增强？在
enhance_query函数中设置参数为False。
使用教程
使用依赖
- Python 3.10或更高版本。
- uv包管理器（推荐）。
- Claude Desktop客户端（用于与Claude一起使用）。
安装教程
- 克隆仓库：
bash git clone https://github.com/yourusername/dnd-knowledge-navigator.git cd dnd-knowledge-navigator - 安装依赖：
bash uv pip install -r requirements.txt或bash pip install . - 配置Claude Desktop（如与Claude一起使用）：
- 在Claude Desktop配置目录中创建
claude_desktop_config.json文件。 - 添加以下配置（根据需要调整路径）：
json { "mcpServers": { "dnd": { "command": "/path/to/uv", "args": [ "--directory", "/path/to/dnd-knowledge-navigator", "run", "dnd_mcp_server.py" ] } } } - 运行服务器：
bash uv run python dnd_mcp_server.py
调试方式
- 运行测试：
bash ./run_tests.py - 启动服务器：
bash python dnd_mcp_server.py