铸造VTT MCP桥
通过模型上下文协议（MCP）将Foundry VTT连接到Claude Desktop，以进行人工智能驱动的活动管理。它目前支持龙与地下城第五版和开拓者第二版。大多数MCP工具与系统无关，但字符创建和汇编工具只能与D&D5e和PF2E一起使用。
概述
Foundry MCP Bridge可与您的Foundry VTT游戏数据进行自然的AI对话：
- 任务创建: 根据提示创建任务，其中包含您的世界和日记中存在的内容
- 角色管理：查询角色统计信息、能力和信息
- 简编检索：使用自然语言查找物品、咒语和生物
- 内容创作：根据简单提示生成演员、NPC和任务日志
- 场景信息：访问当前场景数据和世界详细信息
- 骰子协调：与玩家目标互动的滚动请求
- 活动管理：多部分任务和战役跟踪
- 地图生成：根据提示创建地图，并使用可选的ComfyUI组件将其自动上传到Foundry VTT中的场景中
该项目是在Claude Code的协助下完成的。如果你喜欢这个项目，可以考虑 在Patreon上支持它.
安装
先决条件
- Foundry VTT v13或v14
- 克劳德桌面版 支持MCP
- 视窗 （适用于自动安装程序）或 Node.js 18+ 用于手动安装
选项1:Windows安装程序
- 下载最新
FoundryMCPServer-Setup-vx.x.x.exe从 发布 - 运行安装程序-它将：
- 使用捆绑的Node.js运行时安装MCP服务器 - 配置Claude Desktop MCP服务器设置 - 可选地将Foundry模块和ComfyUI映射生成安装到您的VTT安装中 - 在安装过程中为您的GPU类型选择Cuda版本
- 重新启动克劳德桌面
- 在Foundry模块管理中启用“Foundry MCP桥”
选项2:Mac安装程序
- 下载最新
FoundryMCPServer-vx.x.x.dmg从 发布 - 在dmg中运行包安装程序-它将：
- 打开DMG并双击PKG安装程序 - 配置Claude Desktop MCP服务器设置 - 可选地将Foundry模块和ComfyUI映射生成安装到您的Foundry VTT安装中
- 重新启动克劳德桌面
- 在Foundry模块管理中启用“Foundry MCP桥”
选项3：手动安装
安装Foundry模块
- Open Foundry VTT（v13或v14）
- 在Foundry附加组件菜单中选择安装模块
- 在窗口底部，将Manifest URL添加为：https://github.com/adambdooley/foundry-vtt-mcp/blob/master/packages/foundry-module/module.json然后单击安装
- 在模块管理中启用“Foundry MCP Bridge”
- 不要更改模块ID或文件夹名称。 MCP后端和Claude集成都希望模块位于名为 foundry-mcp-bridge.在中重命名ID module.json 中断套接字路由并阻止Claude看到后端。
安装MCP服务器
# Clone repository
git clone https://github.com/adambdooley/foundry-vtt-mcp.git
cd foundry-vtt-mcp
# Install dependencies and build
npm install
npm run build
配置Claude桌面
将此添加到您的Claude Desktop配置（Claude_Desktop_config.json）文件中：
{
"mcpServers": {
"foundry-mcp": {
"command": "node",
"args": ["path/to/foundry-vtt-mcp/packages/mcp-server/dist/index.js"],
"env": {
"FOUNDRY_HOST": "localhost",
"FOUNDRY_PORT": "31415"
}
}
}
}启动Claude Desktop将启动MCP服务器。
入门指南
- 启动Foundry VTT并加载您的世界
- 打开克劳德桌面
- 与Claude聊天，了解您当前加载的Foundry World
示例用法
连接后，询问Claude Desktop：
- _“给我看我的角色克拉克的统计数据”_
- _“查找所有CR 12类人生物进行邂逅”_
- _“创建一个关于调查失踪村民的任务”_
- _“对Tulkas进行秘密检查”_
- _“当前Foundry场景中有什么？”_
- _“为我制作一张铸造厂河滨小屋的小地图”_
特性
- 36个MCP工具 允许Claude与Foundry进行交互
- 角色管理：访问统计数据、能力、库存和详细的实体信息
- 代币操纵：移动、更新、删除令牌和管理状态条件
- 增强的简编搜索：按CR、类型、能力等即时过滤
- 内容创作：生成演员、NPC和任务日志
- 活动管理：使用进度仪表板进行多部分任务跟踪
- 交互式骰子系统：向Claude的玩家发送不同的掷骰子请求
- 演员所有权：管理角色和令牌的玩家权限
- 仅限GM：MCP网桥仅连接Game Master用户
- 地图生成：便携式ComfyUI后端，可根据提示生成作战图
- 远程连接：通过浏览器启动WebRTC连接（用谷歌Chrome测试）到MCP服务器和ComfyUI
- Windows和Mac安装程序 自动安装Claude Dekstop的Foundry MCP服务器、Foundry MCP Bridge Foundry VTT模块和具有依赖关系的ComfyUI后端
MCP工具
- 1 获取世界信息
- 2 列出场景
- 3 获取当前场景
- 4 获取可用条件
- 5 列出汇编包
- 6 列出字符
- 7 获取角色
- 8 搜索字符项
- 9 获取字符实体
- 10 获取令牌详细信息
- 11 切换令牌条件（添加）
- 12 切换令牌条件（删除）
- 13 更新令牌
- 14 搜索简编
- 15 获取目录项
- 16 获取完整的简编条目
- 17 按标准列出生物
- 18 列出期刊
- 19 创建任务日志
- 20 更新任务日志
- 21 搜索期刊
- 22 联系全国人大
- 23 列出演员所有权
- 24 分配参与者所有权
- 25 删除参与者所有权
- 26 移动令牌
- 27 使用项目
- 28 请求玩家滚动
- 29 生成地图
- 30 检查地图状态
- 31 取消地图作业
- 32 切换场景
- 33 从纲要中创建演员
- 34 list-dsa5-archetyps
- 35 create-dsa5-character-from-archetype
- 36 创建活动控制面板
设置
- 增强生物指数 配置增强索引按钮可进入增强生物索引子菜单（详细信息如下）
- 地图生成服务配置 配置地图生成按钮可进入地图生成服务子菜单（详细信息如下）
- 启用MCP网桥 默认情况下应选中此项，状态应显示为已连接。它可用于关闭游戏中的MCP网桥连接，而无需禁用插件本身。
- 连接类型 可设置为“自动”以自动检测连接类型。也可以设置为强制WebRTC用于互联网连接或强制Websocket用于本地连接。
- Websocket服务器主机 克劳德桌面MCP服务器位置的IP地址。仅用于本地网络websocket连接。远程服务器使用WebRT。默认为localhost。
- 允许写入操作 这将阻止克劳德对世界内容进行任何更改，并将其限制为只读
- 每次请求的最大演员数 这是一种故障保护机制，可以阻止从一个请求创建大量参与者。它不限制多个请求创建的字符数
- 显示连接消息 这可以关闭Foundry MCP Bridge连接的横幅消息
- 断开连接时自动重新连接 如果连接丢失，将自动尝试重新连接
- 连接检查频率 多久检查一次连接状态
增强生物索引子菜单
- 重建生物索引 如果出现问题或与简编中的更改不同步，此按钮将重建生物索引
- 启用增强生物索引 当Claude在世界文件中构建额外的元数据以提供更好的搜索时，应该保留这一点
- 包更改时自动重建索引 尚未完全测试的实验功能
地图生成服务子菜单
- 服务状态 有三个按钮用于检查状态、启动服务和停止服务。这些按钮有助于监视和控制从Foundry MCP桥到由Claude Desktop应用程序启动的ComfyUI后端的连接。
- 自动启动地图生成服务 控制在Foundry世界启动时是否自动连接ComfyUI服务连接。
- 发电质量 使用ComfyUI控制SDXL检查点生成的贴图的质量。低使用8步生成，中使用20步生成，高使用35步生成。本次图像生成中使用的D&D Battlemaps SDXL Upscale v1.0 Checkpoint建议使用35个步骤，但在低端GPU或没有CUDA的GPU上，这一代将需要几分钟的时间。这些选项可以让你以牺牲质量为代价，更快地生成地图。
建筑
Claude Desktop ↔ MCP Protocol ↔ MCP Server ↔ WebSocket ↔ Foundry Module ↔ Foundry VTT
↓
ComfyUI Service
(AI Map Generation)- 铸造模块：在Foundry VTT中提供安全的数据访问
- MCP服务器：处理Claude Desktop通信的外部Node.js服务器
- 地图生成服务：由Claude Desktop开发的无头ComfyUI后端
- 不需要API密钥：使用您现有的Claude Desktop订阅
安全和权限
- 仅限GM访问：所有功能仅限于Game Master用户
- 可配置权限：控制Claude可以访问和修改哪些数据
- 基于会话的身份验证：使用Foundry的内置身份验证系统
系统要求
- 铸造VTT：版本13
- 克劳德桌面版：支持MCP的最新版本
- 克劳德Pro/Max计划：需要连接到MCP服务器
- 操作系统：Windows 10/11（安装程序），或其他操作系统/使用Node.js 18+手动安装Windows（手动）
- GPU要求：至少8GB VRAM的GPU
模式烟雾测试
MCP模式冒烟测试验证工具模式是否正确加载，并且不会强制执行过于严格的操作 additionalProperties 默认值。
npm -w @foundry-mcp/server run build
npm run test:mcp:schema支持与发展
- 问题：报告错误
- YouTube频道: 订阅更新和教程
- 文档：使用TypeScript构建，包括全面的文档
- 许可证：MIT许可证（对于安装程序的捆绑组件，还包括其他第三方许可证）