铸造VTT MCP桥接模块
备注：此存储库仅包含Foundry模块。有关包括MCP服务器、安装程序和ComfyUI集成的完整软件包，请参阅 主存储库.
为什么是这个模块？
因为我家里的Mac很慢，本地的ComfyUI生成地图的时间太长了。因此，我设置了自己的RunPod无服务器实例，从下载了Safe Tensor模型和其他文件 我要结婚了。，vibe编码了添加 RunPod到目前为止，它对我来说非常有效。
整个两阶段过程所需的文件是：
- dD作战图SDXL10_v10.安全张量
- dD作战地图SDXL10_v10.yaml
- dD作战图SDXL10_upscaleV10安全张量 （可选，但它们看起来更好。）
- dD作战地图SDXL10_upscaleV10.yaml
在RunPod设置中，创建一个30GB左右的网络卷，并使用以下结构将文件上传到/workspace：
/workspace/
checkpoints/ < safetensor files go here
configs/ < config files go here有关更多详细说明，请参阅 RunPod操作指南.
叉增强功能
这个叉子增加了：
- 两阶段RunPod工作流程：使用基础模型+高级细化来增强地图生成，以获得更高质量的作战地图
- 改进提示：更好的负面提示和增强的提示模板，用于生成作战图
- 可配置工作流：通过Foundry设置在单级（更快）和两级（更高质量）之间切换
- RunPod集成：直接支持RunPod无服务器GPU端点
概述
Foundry MCP Bridge模块为AI交互提供了对Foundry VTT游戏数据的安全、仅限GM的访问：
- 任务创建：根据包含您的世界和日记的提示创建任务
- 角色管理：查询角色统计信息、能力和信息
- 简编检索：使用自然语言查找物品、咒语和生物
- 内容创作：根据提示生成演员、NPC和任务日志
- 场景信息：访问当前场景数据和世界详细信息
- 骰子协调：与玩家目标互动的滚动请求
- 活动管理：多部分任务和战役跟踪
- 地图生成：使用RunPod或本地ComfyUI支持的人工智能作战图创建
支持的系统：D&D 5e、探路者2e（核心工具与系统无关）
鸣谢
该项目是在Claude Code的协助下完成的。
安装
选项1：通过清单URL（推荐）
- Open Foundry VTT v13或v14
- 导航至 附加模块 → 安装模块
- 将此清单URL粘贴到底部：
https://github.com/ctbritt/foundry-mcp-bridge/releases/latest/download/module.json- 点击 安装
- 在模块管理中启用“Foundry MCP Bridge”
选项2：从源手动安装
# Clone this repository
git clone https://github.com/ctbritt/foundry-mcp-bridge.git
cd foundry-mcp-bridge
# Install dependencies and build
npm install
npm run build
# Copy to your Foundry modules directory
# Linux/Mac:
cp -r . ~/foundryuserdata/Data/modules/foundry-mcp-bridge/
# Windows:
# Copy the entire directory to %localappdata%\FoundryVTT\Data\modules\foundry-mcp-bridge\入门指南
- 安装并配置 MCP服务器 （有关说明，请参阅主仓库）
- 启动Foundry VTT并启用此模块
- 打开克劳德桌面（应自动启动MCP服务器）
- 与Claude聊天，了解您当前加载的Foundry世界！
示例用法
连接后，询问Claude Desktop：
- *“给我看我的角色克拉克的统计数据”*
- *“查找所有CR 12类人生物进行邂逅”*
- *“创建一个关于调查失踪村民的任务”*
- *“对Tulkas进行秘密检查”*
- *“当前Foundry场景中有什么？”*
- *“为我制作一张铸造厂河滨小屋的小地图”*
模块功能
此模块提供桥接器的Foundry VTT侧：
- 安全数据访问：所有MCP工具的GM查询处理程序
- 角色管理：将角色统计数据、能力和库存暴露给AI
- 增强的简编搜索：预先计算的生物指数，用于即时过滤
- 内容创作：支持人工智能生成的演员、NPC和任务期刊
- 活动追踪：仪表板生成和任务进度监控
- 交互式骰子系统：处理滚动请求并与玩家协调
- 演员所有权：AI创建内容的权限管理
- 地图生成:
- RunPod无服务器GPU集成 - 两阶段工作流程（基础+高端），实现更高质量 - 通过MCP服务器支持本地ComfyUI
- 连接类型:
- WebSocket用于本地网络 - WebRTC用于远程/HTTPS连接
- GM专用安全：所有MCP操作都需要Game Master权限
两阶段地图生成工作流程
此分叉包括用于RunPod地图生成的增强的两阶段工作流程：
运作原理
- 第一阶段-基础生成：使用以下命令以较低分辨率创建图像
dDBattlemapsSDXL10_v10.safetensors - 第二阶段-升级和精炼：升级2倍并使用以下功能细化细节
dDBattlemapsSDXL10_upscaleV10.safetensors
配置
通过Foundry模块设置启用：
- 使用两阶段工作流（RunPod）：在单级（更快）和两级（更高质量）之间切换
- 发电质量:
- 低：10-15步（快速，适合测试） - 中等：20-25步（平衡） - 高：45-50步（质量最好，速度较慢）
需求
对于RunPod上的两阶段工作流，您需要两种模型：
dDBattlemapsSDXL10_v10.safetensors（基础模型）dDBattlemapsSDXL10_upscaleV10.safetensors（高档车型）sdxl_vae.safetensors（VAE）
演出
- 单级：30-90秒，直接以目标分辨率生成
- 两级：60-180秒，通过基础+高端方式获得更好的质量
关键设置
该模块包括几个配置选项：
- 连接设置：自动检测或强制WebSocket/WebRTC
- 安全：启用/禁用写入操作，每个请求的最大参与者数
- 增强生物指数：用于即时生物过滤的预计算元数据
- 地图生成：服务类型（本地/RunPod）、质量、工作流类型
- 自动重新连接：断开连接时自动重新连接
有关详细设置信息，请参阅Foundry VTT中的模块配置菜单。
建筑
该模块是更大的MCP网桥系统的一个组件：
Claude Desktop
↓
MCP Protocol
↓
MCP Server (Node.js) ←→ ComfyUI/RunPod
↓
WebSocket/WebRTC
↓
[This Module] ← Running inside Foundry VTT
↓
Foundry VTT Game Data本模块的作用:
- 通过WebSocket/WebRTC从MCP服务器接收MCP查询
- 使用Foundry的游戏数据API处理查询
- 将结果返回给Claude Desktop的MCP服务器
- 管理对RunPod或本地ComfyUI的地图生成请求
- 在Foundry级别强制实施仅限GM的安全措施
安全和权限
- 仅限GM访问：所有MCP操作仅限于Game Master用户
- 可配置权限：可选只读模式，防止修改
- 速率限制：每次请求的最大参与者数，以防止滥用
- 无外部API：适用于您现有的Claude Desktop订阅
系统要求
- 铸造VTT：版本13或14
- MCP服务器：已安装和配置（请参阅 主存储库)
- 用于地图生成:
- 具有无服务器端点的RunPod帐户，OR - 配备8GB+VRAM GPU的本地ComfyUI安装
发展
这是一个TypeScript项目。要从源代码构建，请执行以下操作：
npm install
npm run build # Compile TypeScript
npm run dev # Watch mode for development
npm run typecheck # Type check without building支持和链接
- 原始项目: 铸造VTT MCP桥 亚当·杜利
- 支持Adam: Patreon
- 油管: 教程和更新
- 分叉问题:
- 许可证：MIT许可证（见许可证文件）