D&D 5e API MCP服务器
一种模型上下文协议（MCP）服务器，提供与D&D 5e API交互的工具。该服务器使AI助手能够查询《龙与地下城》第5版的数据，包括法术、怪物、职业、装备等。
______________________________________________________________________
特性
可用工具
- list_endpoints -获取所有可用的API端点
- 列表_资源 -列出特定端点的所有资源（例如，所有法术）
- 获取资源 -获取特定资源的详细信息
- search_spells -使用过滤器搜索法术（级别、学校、班级）
- search_monsters -使用过滤器搜索怪物（CR，类型）
- get_class_levels -获得课程的等级提升
- get_ass_spells -获取一个类可用的所有法术
支持的端点
- 能力得分
- 对齐
- 背景
- 班级
- 条件
- 损伤类型
- 设备类别
- 设备
- 壮举
- 特征
- 语言
- 魔法物品
- 魔法学校
- 怪物
- 熟练程度
- 种族
- 规则部分
- 规则
- 技能
- 咒语
- 子类
- 子种族
- 特质
- 武器特性
______________________________________________________________________
安装
先决条件
- Docker和Docker Compose
- Node.js 20+（用于本地开发）
Docker快速入门
- 克隆此存储库：
git clone
cd dnd5e-mcp-server- 创建项目结构：
mkdir -p src
# Move server.ts to src/server.ts- 使用Docker Compose构建和运行：
docker-compose up -d --build或者直接使用Docker构建和运行：
docker build -t dnd5e-mcp-server .
docker run -i dnd5e-mcp-server地方发展
- 安装依赖项：
npm install- 构建TypeScript代码：
npm run build- 运行服务器：
npm start______________________________________________________________________
用法
使用克劳德桌面
将此添加到您的Claude Desktop配置文件中：
- MacOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"dnd5e": {
"command": "docker",
"args": ["run", "-i", "--rm", "dnd5e-mcp-server:latest"]
}
}
}或者为了当地发展：
{
"mcpServers": {
"dnd5e": {
"command": "node",
"args": ["/path/to/dnd5e-mcp-server/dist/server.js"]
}
}
}查询示例
配置后，您可以询问Claude：
- “五级巫师可以施展什么法术？”
- “显示所有CR 5龙”
- “获取火球法术的详细信息”
- “战斗机有什么装备？”
- “列出所有三级召唤法术”
- “10级圣骑士有什么特点？”
______________________________________________________________________
API 参考
服务器使用 D&D 5e API 其提供来自D&D第5版系统参考文件（SRD）的数据。
工具调用示例
获取一个特定的咒语：
{
"name": "get_resource",
"arguments": {
"endpoint": "spells",
"index": "fireball"
}
}搜索法术：
{
"name": "search_spells",
"arguments": {
"level": 3,
"school": "evocation",
"class": "wizard"
}
}通过CR获取怪物：
{
"name": "search_monsters",
"arguments": {
"challenge_rating": 10,
"type": "dragon"
}
}______________________________________________________________________
发展
项目结构
dnd5e-mcp-server/
├── src/
│ └── server.ts # Main server implementation
├── dist/ # Compiled JavaScript (generated)
├── Dockerfile # Docker image definition
├── docker-compose.yml # Docker Compose configuration
├── package.json # Node.js dependencies
├── tsconfig.json # TypeScript configuration
└── README.md # This file建筑
# Install dependencies
npm install
# Compile TypeScript
npm run build
# Build Docker image
docker build -t dnd5e-mcp-server .测试
您可以使用MCP检查器测试MCP服务器：
npx @modelcontextprotocol/inspector node dist/server.js______________________________________________________________________
许可证
MIT许可证
______________________________________________________________________
鸣谢
- 建立在 模型上下文协议SDK
- 数据由 D&D 5e API
- D&D 5e内容来自开放游戏许可证（OGL）下的系统参考文件（SRD）
______________________________________________________________________
贡献
欢迎投稿！请随时提交拉取请求。
______________________________________________________________________
支持
关于以下问题：
- MCP服务器： 在此存储库中打开问题
- D&D 5e API： 访问 5e位/5e srd api
- MCP协议： 访问 模型上下文协议