AI导哈

D&D角色管理协议服务器

一个为D&D Beyond提供角色、战役、法术等数据访问的TypeScript MCP服务器，支持AI助手集成。

  • by AlexWorland
  • TypeScript
  • 本地部署
  • 21 星标
  • 更新于
在 GitHub 查看 AlexWorland/dndbeyond-mcp

使用说明

dndbeyond mcp

用于D&D Beyond的TypeScript MCP（模型上下文协议）服务器。让克劳德（和其他兼容MCP的AI助手）访问你的D&D Beyond角色、战役、咒语、怪物、物品等。

免责声明： 该项目使用非官方的反向工程D&D Beyond端点。它不隶属于D&D Beyond或海岸奇才队，也不受其认可或支持。端点可能会更改，恕不另行通知。

特性

  • 角色管理 --阅读角色表、更新生命值、法术槽、死亡保存、货币
  • 活动访问权限 --列出活动，查看政党名册
  • 参考查询 --搜索和检索法术、怪物、魔法物品、专长、条件、职业
  • 工作流提示 --会话准备、遭遇构建、升级指导、拼写建议
  • 基于浏览器的身份验证 --Playwright驱动的登录流程（无需手动提取cookie）

安装

您可以运行此服务器，而无需通过安装 npx:

npx dndbeyond-mcp

或全局安装：

npm install -g dndbeyond-mcp

设置

在使用服务器之前，请向D&D Beyond进行身份验证：

npx dndbeyond-mcp setup

这将打开一个浏览器窗口，您可以在其中正常登录D&D Beyond。服务器会自动捕获您的会话cookie并将其保存到 ~/.dndbeyond-mcp/config.json.

Claude桌面配置

将此添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "dndbeyond": {
      "command": "npx",
      "args": ["-y", "dndbeyond-mcp"]
    }
  }
}

添加配置后，重新启动Claude Desktop。

工具

角色

  • get_character --按ID或姓名列出的完整字符表
  • list_characters --你所有的角色
  • update_hp --施加伤害或愈合
  • update_spell_slots --使用或恢复法术槽
  • update_death_saves --创纪录的死亡拯救
  • update_currency --修改金/银/铜
  • use_ability --限制使用功能

活动

  • list_campaigns --您的活跃活动
  • get_campaign_characters --活动中的所有角色

参考

  • search_spells / get_spell --使用过滤器进行拼写查找
  • search_monsters / get_monster --怪物属性块
  • search_items / get_item --魔法物品目录
  • search_feats --Feat发现
  • get_condition --条件规则
  • search_classes --类/子类信息

效用

  • setup_auth --重新运行登录流程
  • check_auth --验证会话是否有效

资源

URI 描述
dndbeyond://characters 您的角色列表
dndbeyond://character/{id} 字符表
dndbeyond://character/{id}/spells 拼写列表
dndbeyond://character/{id}/inventory 库存
dndbeyond://campaigns 您的活动
dndbeyond://campaign/{id}/party 政党名册

提示

提示 目的
character-summary 完整角色概述
session-prep DM会话准备
encounter-builder 平衡的相遇设计
spell-advisor 拼写建议
level-up-guide 升级演练
rules-lookup 规则澄清

安全

此服务器将您的D&D Beyond会话cookie存储在本地 ~/.dndbeyond-mcp/config.json。cookie提供对您D&D Beyond帐户的完全访问权限。永远不要共享此文件。服务器仅与 dndbeyond.com 域。

许可证

麻省理工学院

相关 MCP