MCP Dnd 5e

DnD 5e MCP服务器

MCP 服务器展示 GraphQL API D&D 5e SRD 对于LLMS VIA 模型上下文协议与Claude Desktop和ChatGPT兼容。

功能

• 2工具: graphql_query （查询执行） + explore_schema （动态类型内省）
• 1个提示: dnd5e_guide — 具有示例的详细指南，可应要求提供 player/dm/general 上下文
• instructions 自动注入客户端系统提示符（ schema， Union types， typed filters）
• 缓存Redis 基于元数据的 stale-while-revalidate
• 双重运输：流式HTTP+SSE（legado）
• 速率限制 按 IP， 可配置 CORS， graceful shutdown
• Docker Compose 两项服务的健康检查

快速开始

1. 设置环境变量

cp .env.example .env
# Editar .env se necessário (os defaults funcionam para deploy local)

2. 抬起集装箱

docker compose up --build -d

等待这两项服务保持健康：

docker compose ps
# NAME          STATUS                 PORTS
# mcp-mcp-1     Up (healthy)          0.0.0.0:3000->3000/tcp
# mcp-redis-1   Up (healthy)          6379/tcp

3. 检查

curl http://localhost:3000/health
# {"status":"ok","redis":true,"activeSessions":0,"uptime":...}

完全重建

docker compose down
docker compose up --force-recreate --build --remove-orphans -d

MCP 客户端配置

克劳德桌面版

添加到 claude_desktop_config.json （设置→ 开发者→ 编辑配置）：

{
  "mcpServers": {
    "dnd-5e": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

保存后重新启动 Claude 桌面 。

生产

{
  "mcpServers": {
    "dnd-5e": {
      "url": "https://mcp.dnd.carromeu.com/mcp"
    }
  }
}

环境变量

地方 发展

没有 Docker（需要 Redis 单独运行）：

npm install
npm run dev     # tsx com hot reload

构建和运行：

npm run build
npm start

端点

建筑

有关架构、设计决策和技术堆栈的完整技术详情，请参阅 docs/tech-spec.md.

技术栈

• 运行时：Node.js 22 LTS（Alpine）+TypeScript 5.x
• MCP-SDK: @modelcontextprotocol/sdk 1.27.x
• 超文本传输协议：快递5.x
• 图查询语言: graphql-request 7.x com rawRequest() + errorPolicy: 'all'
• 缓存：Redis 7（Alpine）通过 ioredis 5.x
• 基础设施：Docker多阶段构建+Docker编写

许可证

麻省理工学院