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 域。
许可证
麻省理工学院