D&D超越MCP服务器
A. 模型上下文协议（MCP） 服务器，让克劳德直接访问你的D&D Beyond帐户——角色、战役、原始资料、咒语、怪物等等。
特性
| 工具 | 说明 |
|---|---|
ddb_login | 使用D&D Beyond（Wizards ID）进行身份验证。运行一次将会话保存到磁盘。 |
ddb_list_characters | 列出您帐户中的所有字符，包括ID、级别、种族和类别。 |
ddb_get_character | 从D&D Beyond字符API获取完整字符JSON。 |
ddb_download_character | 将字符的完整JSON数据保存到本地文件。 |
ddb_list_campaigns | 列出你参与的所有活动（作为DM或玩家）。 |
ddb_get_campaign | 获取活动详细信息——DM、描述和活动角色。 |
ddb_list_library | 列出您拥有、购买或与您共享的所有原始资料。 |
ddb_read_book | 从自有资源书中阅读内容，可选择按章节slug阅读。 |
ddb_search | 搜索法术、怪物、魔法物品、种族、职业或专长。 |
ddb_navigate | 导航到任何D&D Beyond URL并返回其文本内容。 |
ddb_interact | 单击、填充或截图当前加载的浏览器页面。 |
ddb_current_page | 返回当前加载的任何页面的文本内容。 |
先决条件
- 18岁或以后
- 克劳德代码 命令行界面
安装
选项A——直接从GitHub安装（推荐）
npm install -g "https://github.com/ddb-mcp/ddb-mcp/archive/refs/heads/main.tar.gz"然后安装浏览器：
npx playwright install chromium找到安装路径并使用Claude Code注册：
npm root -g
# outputs something like /usr/local/lib/node_modulesclaude mcp add dndbeyond node /usr/local/lib/node_modules/ddb-mcp/dist/index.js______________________________________________________________________
选项B--手动克隆和构建
git clone https://github.com/ddb-mcp/ddb-mcp.git
cd ddb-mcp
npm install
npx playwright install chromium注册克劳德代码：
claude mcp add dndbeyond node /absolute/path/to/ddb-mcp/dist/index.js或编辑 ~/.claude/settings.json 手动：
{
"mcpServers": {
"dndbeyond": {
"command": "node",
"args": ["/absolute/path/to/ddb-mcp/dist/index.js"]
}
}
}用法
首次登录
第一次使用服务器时，您需要进行身份验证：
ddb_login浏览器窗口（Chrome for Testing）将打开并导航到D&D Beyond登录页面。使用您的Wizards ID帐户完成登录。一旦您被重定向回D&D Beyond，您的会话将自动保存到 ~/.config/ddb-mcp/session.json 并在未来的所有通话中重复使用。
您只需登录一次。如果您的会话到期，只需运行 ddb_login 再一次。
示例提示
列出您的角色：
List all my D&D Beyond characters获取完整字符数据：
Get the full character sheet for character ID 140476673列出您的活动：
What campaigns am I part of on D&D Beyond?获取活动详细信息：
Show me the details for campaign 6709239, including all the player characters搜索法术：
Search D&D Beyond for spells named "Fireball"寻找怪物：
Find the Beholder stat block on D&D Beyond阅读原始资料：
Show me the table of contents for the Player's HandbookRead the Barbarian class section from the Player's Handbook下载角色：
Download the character data for Roland Stonehelm to my Downloads folder查找角色和活动ID
- 字符ID：字符URL中的数字--
dndbeyond.com/characters/140476673 - 活动ID：活动URL中的数字--
dndbeyond.com/campaigns/6709239
您还可以使用 ddb_list_characters 和 ddb_list_campaigns 在不离开克劳德的情况下获得身份证。
书蛞蝓for ddb_read_book
使用 ddb_list_library 为你所拥有的任何一本书争取奖金。示例：
| 书 | 蛞蝓 |
|---|---|
| 玩家手册（2024） | dnd/phb-2024 |
| 地牢大师指南（2024） | dnd/dmg-2024 |
| 怪物手册（2024） | dnd/mm-2024 |
| 玩家手册（2014） | dnd/phb-2014 |
要阅读特定章节，请在书符后传递章节路径：
ddb_read_book("dnd/phb-2024", "character-classes/barbarian")升级
要升级到最新版本，请再次运行install命令——npm将覆盖现有安装：
npm install -g "https://github.com/ddb-mcp/ddb-mcp/archive/refs/heads/main.tar.gz"要安装特定的标记版本，请执行以下操作：
npm install -g "https://github.com/ddb-mcp/ddb-mcp/archive/refs/tags/v1.0.2.tar.gz"然后重新启动Claude Code并运行 /mcp 重新连接服务器。
会话存储
您的会话已保存到 ~/.config/ddb-mcp/session.json。此文件包含您D&D Beyond登录时的浏览器Cookie和本地存储。将此文件保密——它授予对您帐户的访问权限。
要注销或重置会话，请删除文件：
rm ~/.config/ddb-mcp/session.json发展
# Run in development mode (no build step needed)
npm run dev
# Build
npm run build
# Watch mode
npm run build:watch许可证
麻省理工学院