D&D 知识导航器是一个基于 Python 的服务器,它实现了模型上下文协议(MCP),能将像 Claude 这样的人工智能助手与《龙与地下城》第 5 版(D&D 5e)的游戏信息连接起来,为玩家和开发者提供便捷的游戏数据查询和交互体验。
# 克隆仓库
git clone https://github.com/yourusername/dnd-knowledge-navigator.git
cd dnd-knowledge-navigator
# 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate # 在 Windows 上:.venv\Scripts\activate
# 以开发模式安装包
pip install -e .
使用以下命令安装项目及其依赖:
pip install -r requirements.txt
config.json
文件,并添加以下内容:{
"api_key": "your_api_key_here",
"debug_mode": true,
"port": 5000
}
DND_API_KEY
:访问 D&D API 所需的密钥。DEBUG_MODE
:启用调试模式(可选)。python dnd_mcp_server.py --config config.json
./run_tests.py
# 克隆仓库
git clone https://github.com/yourusername/dnd-knowledge-navigator.git
cd dnd-knowledge-navigator
# 创建并激活虚拟环境
python -m venv .venv
source .venv/bin/activate # 在 Windows 上:.venv\Scripts\activate
# 以开发模式安装包
pip install -e .
pip install -r requirements.txt
config.json
文件,并添加以下内容:{
"api_key": "your_api_key_here",
"debug_mode": true,
"port": 5000
}
DND_API_KEY
:访问 D&D API 所需的密钥。DEBUG_MODE
:启用调试模式(可选)。python dnd_mcp_server.py --config config.json
python dnd_mcp_server.py
./run_tests.py
项目提供了详细的文档,涵盖包结构、安装指南、运行说明以及贡献流程。对于更深入的理解,请查阅 docs
目录中的内容。
D&D 知识导航器作为一个 Python 包,具有以下结构:
dnd-knowledge-navigator/
├── dnd_mcp_server.py # 主服务器入口点
├── run_tests.py # 运行所有测试的脚本
├── setup.py # 安装配置文件
├── src/ # 源代码目录
│ ├── __init__.py # 包初始化
│ ├── attribution/ # 来源归属系统
│ ├── core/ # 核心功能
│ ├── query_enhancement/ # 查询增强系统
│ └── templates/ # 响应格式化模板
├── tests/ # 测试目录
│ ├── __init__.py # 测试包初始化
│ └── test_*.py # 测试文件
└── docs/ # 文档
模型上下文协议(MCP)是由 Anthropic 开发的一个框架,使人工智能助手如 Claude 能够与外部工具和服务进行通信。此服务器利用了 FastMCP(Anthropic 工具的 Python 实现),以将这些功能连接到《龙与地下城》5 版的数据。
此项目在 MIT 许可证下发行。请查看 LICENSE 文件以获取详细信息。
欢迎贡献!请随意提交拉取请求。
git checkout -b feature/amazing-feature
)git commit -m 'Add some amazing feature'
)git push origin feature/amazing-feature
)