Foundry VTT MCP 桥接服务器是一个创新的工具，它允许您将流行桌面角色扮演游戏平台 Foundry VTT 与支持 Model Context Protocol (MCP) 的 AI 模型（如 Claude Desktop）无缝集成。通过这个桥接，AI 可以理解您的游戏世界、角色、物品和场景，并根据您的指令执行各种操作，从而极大地提升战役管理和内容创作效率。

主要功能点

智能战役管理: AI 可协助创建任务、管理多部分战役进度，甚至根据世界现有内容生成新的冒险。
角色与物品查询: 自然语言查询角色统计数据、能力、物品，或在图鉴（Compendium）中搜索生物、法术和道具。
内容自动化生成: 依据简单指令创建新的 NPC、角色扮演者（Actor）和任务日志。
场景互动: 访问当前场景信息，AI 可以了解地图布局和令牌位置。
骰子协同: AI 可以请求玩家进行特定骰子投掷，并处理结果。
权限与安全: 所有操作仅限于游戏管理员（GM），并支持细粒度权限控制，确保游戏世界安全。

安装步骤

前提条件

Foundry VTT v13 或更高版本
支持 MCP 协议的 Claude Desktop 客户端
Node.js 18+ (如果选择手动安装服务器)

推荐方式：Windows 安装程序

从 Foundry VTT MCP GitHub 仓库的 Releases 页面下载最新的 'FoundryMCPServer-Setup.exe'。
运行安装程序，它会自动：
- 安装 MCP 服务器及其捆绑的 Node.js 运行时。
- 自动配置 Claude Desktop。
- 选择性地将 Foundry 模块安装到您的 Foundry VTT 目录。
重启 Claude Desktop。
在 Foundry VTT 的模块管理界面中，启用 "Foundry MCP Bridge" 模块。

手动安装方式 (适用于非 Windows 系统或自定义配置)

安装 Foundry 模块:
- 打开 Foundry VTT v13。
- 在 Foundry 附加组件菜单中选择 "安装模块"。
- 在窗口底部，添加清单 URL：'https://github.com/adambdooley/foundry-vtt-mcp/blob/master/packages/foundry-module/module.json' 并点击安装。
- 在模块管理界面中，启用 "Foundry MCP Bridge" 模块。
安装 MCP 服务器:
- 克隆 GitHub 仓库：'git clone https://github.com/adambdooley/foundry-vtt-mcp.git'
- 进入项目目录：'cd foundry-vtt-mcp'
- 安装依赖并构建：'npm install' 然后 'npm run build'
配置 Claude Desktop:
- 打开您的 'claude_desktop_config.json' 文件（通常位于 Claude Desktop 的用户数据目录）。
- 在 'mcpServers' 部分添加以下配置。请将 '<path/to/your/foundry-vtt-mcp>' 替换为您克隆仓库的实际绝对路径：
```
{
  "mcpServers": {
    "foundry-mcp": {
      "command": "node",
      "args": ["<path/to/your/foundry-vtt-mcp>/packages/mcp-server/dist/index.js"],
      "env": {
        "FOUNDRY_HOST": "localhost",
        "FOUNDRY_PORT": "31415"
      }
    }
  }
}
```
  - 'foundry-mcp': 服务器的唯一名称。
  - 'command': 启动 MCP 服务器的命令，这里是 'node'。
  - 'args': 传递给 'node' 命令的参数，即 MCP 服务器的主入口文件路径。
  - 'env': 环境变量，用于配置 MCP 服务器连接 Foundry VTT 的主机和端口。
    - 'FOUNDRY_HOST': Foundry VTT 运行的 IP 地址（通常是 'localhost'）。
    - 'FOUNDRY_PORT': Foundry VTT 的端口（默认是 '31415'）。
- 保存并关闭 'claude_desktop_config.json' 文件。
- 启动 Claude Desktop 后，MCP 服务器将自动启动并尝试连接 Foundry VTT。

基本使用方法

启动 Foundry VTT 并加载您的世界。
打开 Claude Desktop。
直接与 Claude 对话，询问关于您 Foundry 世界的问题或请求其执行任务：
- "告诉我我的角色 Clark 的统计数据"
- "寻找所有 CR 12 的类人生物以用于遭遇战"
- "创建一个关于调查失踪村民的任务"
- "为 Tulkas 掷一个潜行检定"
- "当前 Foundry 场景中有什么？"

关键词

主要功能点

安装步骤

前提条件

推荐方式：Windows 安装程序

手动安装方式 (适用于非 Windows 系统或自定义配置)

基本使用方法

信息