STARWARCLOUD STARWAR.AI
返回市场
锻造-vtt-mcp

锻造-vtt-mcp

作者：adambdooley14 星标更新：2025-11-22
安装使用来源：spider==github.com

项目介绍

Foundry VTT MCP Bridge

通过模型上下文协议（MCP），将Foundry VTT连接到Claude Desktop，以实现AI驱动的战役管理。目前支持龙与地下城第五版和Pathfinder第二版。大多数MCP工具是系统无关的，但角色创建和资料库工具仅能与D&D5e和PF2E一起使用。

概述

Foundry MCP Bridge使您能够与Foundry VTT游戏数据进行自然的AI对话：

  • 任务创建：从提示中创建任务，这些提示结合了您世界和日志中的内容
  • 角色管理：查询角色状态、能力和信息
  • 资料库搜索：使用自然语言查找物品、法术和生物
  • 内容创作：根据简单提示生成演员、NPC和任务日志
  • 场景信息：访问当前场景数据和世界细节
  • 骰子协调：具有玩家目标的交互式掷骰请求
  • 战役管理：多部分任务和战役跟踪
  • 地图生成：根据提示创建地图，并使用可选的ComfyUI组件自动上传到Foundry VTT场景中

该项目在Claude Code的帮助下构建。如果您喜欢这个项目，请考虑在Patreon上支持它。

安装

先决条件

  • Foundry VTT v13
  • 支持MCP的Claude Desktop
  • Windows（用于自动化安装程序）或Node.js 18+（用于手动安装）

方案1：Windows安装程序

Windows安装程序视频指南

  1. 从发布页面下载最新版本的FoundryMCPServer-Setup-vx.x.x.exe
  2. 运行安装程序 - 它会：
    • 安装带有捆绑Node.js运行时的MCP服务器
    • 配置Claude Desktop MCP服务器设置
    • 可选地安装Foundry模块和ComfyUI地图生成到您的VTT安装
    • 在安装过程中选择适合您GPU类型的CUDA版本
  3. 重启Claude Desktop
  4. 在Foundry模块管理中启用“Foundry MCP Bridge”

方案2：Mac安装程序

  1. 从发布页面下载最新版本的FoundryMCPServer-vx.x.x.dmg
  2. 运行dmg内的包安装程序 - 它会：
    • 打开DMG并双击PKG安装程序
    • 配置Claude Desktop MCP服务器设置
    • 可选地安装Foundry模块和ComfyUI地图生成到您的Foundry VTT安装
  3. 重启Claude Desktop
  4. 在Foundry模块管理中启用“Foundry MCP Bridge”

方案3：手动安装

安装Foundry模块

  1. 打开Foundry VTT v13
  2. 在Foundry附加组件菜单中选择安装模块
  3. 在窗口底部添加Manifest URL为：https://github.com/adambdooley/foundry-vtt-mcp/blob/master/packages/foundry-module/module.json 并点击安装
  4. 在模块管理中启用“Foundry MCP Bridge”

安装MCP服务器

# 克隆仓库
git clone https://github.com/adambdooley/foundry-vtt-mcp.git
cd foundry-vtt-mcp

# 安装依赖项并构建
npm install
npm run build

配置Claude Desktop

在您的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服务器。

开始使用

  1. 启动Foundry VTT并加载您的世界
  2. 打开Claude Desktop
  3. 与Claude讨论您当前加载的Foundry世界

示例用法

一旦连接，可以向Claude Desktop询问：

  • "显示我的角色Clark的状态"
  • "找到所有CR 12的人形生物进行遭遇战"
  • "创建一个关于调查失踪村民的任务"
  • "为Tulkas掷一次潜行检定"
  • "当前的Foundry场景里有什么？"
  • "为我创建一个Foundry中的河边小屋的小地图"

功能

  • 25个MCP工具允许Claude与Foundry互动
  • 角色管理：访问状态、能力和库存
  • 增强的资料库搜索：即时过滤CR、类型、能力等
  • 内容创作：生成演员、NPC和任务日志
  • 战役管理：多部分任务跟踪，附带进度仪表板
  • 交互式骰子系统：从Claude发送不同的掷骰请求给玩家
  • 角色所有权：管理玩家对角色和标记的权限
  • 仅限GM：MCP Bridge仅连接到游戏大师用户
  • 地图生成：一个便携式的ComfyUI后端，根据提示生成战斗地图
  • 远程连接：通过浏览器（已测试Google Chrome）发起WebRTC连接到MCP服务器和ComfyUI
  • Windows和Mac安装程序：自动安装Foundry MCP服务器到Claude Dekstop，Foundry MCP Bridge Foundry VTT模块以及ComfyUI后端及其依赖项

设置

设置界面

  • 增强生物索引 配置增强索引按钮将引导至增强生物索引子菜单（详情如下）
  • 地图生成服务配置 配置地图生成按钮将引导至地图生成服务子菜单（详情如下）
  • 启用MCP Bridge 默认应被选中，状态应显示为已连接。可以在不关闭插件本身的情况下，用于在游戏中关闭MCP Bridge连接。
  • 连接类型 可设置为自动检测连接类型。也可以设置为强制使用WebRTC进行互联网连接或使用WebSocket进行本地连接。
  • WebSocket服务器主机 Claude Desktop MCP服务器的位置IP地址。仅用于本地网络WebSocket连接。远程服务器使用WebRT。默认为localhost。
  • 允许写操作 这将阻止Claude对世界内容进行任何更改，限制其仅为读取。
  • 每个请求的最大角色数 这是一个安全措施，防止从单个请求创建大量角色。它不限制多个请求创建的角色数量。
  • 显示连接消息 可以关闭Foundry MCP Bridge连接的横幅消息。
  • 断开连接时自动重连 如果连接丢失，将自动尝试重新连接。
  • 连接检查频率 检查连接状态的频率。

增强生物索引子菜单

增强生物索引子菜单

  • 重建生物索引 如果存在问题或与您的资料库变化不同步，此按钮将重建生物索引。
  • 启用增强生物索引 应保留开启状态，因为Claude会在世界文件中构建额外的元数据，以提供更好的搜索。
  • 资料包更改时自动重建索引 尚未完全测试的实验性功能。

地图生成服务子菜单

地图生成服务子菜单

  • 服务状态 有三个按钮用于检查状态、启动服务和停止服务。这些按钮有助于监控和控制从Foundry MCP Bridge到由Claude Desktop应用程序启动的ComfyUI后端的连接。
  • 自动启动地图生成服务 控制是否在启动Foundry世界时自动连接ComfyUI服务。
  • 生成质量 控制由ComfyUI生成的地图的质量。低质量使用8步生成，中等质量使用20步生成，高质量使用35步。在此图像生成中使用的D&D战斗地图SDXL放大v1.0检查点建议使用35步，但在低端GPU或无CUDA的GPU上，这将需要几分钟的时间。这些选项可以为您提供更快生成地图的折衷方案，以牺牲质量为代价。

架构

Claude Desktop ↔ MCP协议 ↔ MCP服务器 ↔ WebSocket ↔ Foundry模块 ↔ Foundry VTT
                                     ↓
                              ComfyUI服务
                              （AI地图生成）
  • Foundry模块：在Foundry VTT内提供安全的数据访问
  • MCP服务器：处理Claude Desktop通信的外部Node.js服务器
  • 地图生成服务：由Claude Desktop启动的无头ComfyUI后端
  • 无需API密钥：使用您现有的Claude Desktop订阅

安全与权限

  • 仅限GM访问：所有功能都限制为游戏大师用户
  • 可配置权限：控制Claude可以访问和修改的数据
  • 基于会话的身份验证：使用Foundry内置的身份验证系统

系统要求

  • Foundry VTT：版本13
  • Claude Desktop：最新版本，支持MCP
  • Claude Pro/Max计划：连接到MCP服务器所需
  • 操作系统：Windows 10/11（安装程序），或其他OS的手动Windows安装，需Node.js 18+（手动）
  • GPU要求：至少8GB VRAM的GPU

支持与发展