youichi-uda/godot-mcp-pro

Godot MCP Pro – AI 驱动的 Godot 编辑器桥接

是什么 – 一款付费插件，允许大型语言模型助手（Claude、Copilot、Cursor 等）实时控制 Godot 编辑器。它通过一个用 Node.js 编写的 Model Context Protocol（MCP）服务器，经由 WebSocket（默认端口 6505）与编辑器插件通信实现。该服务器公开了 187 个 JSON-RPC 工具，涵盖项目管理、场景图操作、脚本编写、编辑器 UI、输入模拟、运行时检查、动画、物理、导出、测试等多个方面。

为何重要 – 通过将完整编辑器 API 作为 RPC 调用暴露，LLM 可以 查看 项目结构、编辑 节点、运行 脚本、捕获 屏幕截图、模拟 输入，甚至 部署 到 Android——而无需模型直接读写文件。这实现了真正交互式、无需代码的游戏开发，AI 可以像人类一样在编辑器内迭代、测试和调试。

如何工作

1. 安装 Godot 插件 – 将 addons/godot_mcp/ 复制到项目中，并在编辑器设置中启用。
2. 运行 MCP 服务器 – 服务器仅在付费版本中提供。解压后，执行 npm install && npm run build 生成 build/index.js 可执行文件。
3. 配置 AI 客户端 – 在 .mcp.json 文件中添加 mcpServers.godot‑mcp‑pro 条目，指向构建好的 Node 脚本（可选地使用 --lite、--minimal 或 --3d 标志限制工具集，以适应上下文窗口较小的模型）。
4. 连接 – AI 助手通过 stdio/MCP 与服务器通信，服务器通过 WebSocket 将 JSON-RPC 调用转发给 Godot 插件，执行请求的编辑器操作。
5. 使用 – 从 AI 侧可调用全部 187 个工具，例如 project info、node add --type CharacterBody3D --name Player、simulate_key "Space"、run_test_scenario 或 deploy_to_android。

模式与工具数量限制

模式	暴露的工具	典型客户端
完整（默认）	187	Claude Code、VS Code Copilot、Cursor（无硬性限制）
3D (--3d)	100	需要 3D 工具但上限为 100 的客户端
轻量 (--lite)	88	Windsurf、JetBrains Junie、Gemini CLI
最小 (--minimal)	35	OpenCode、上下文窗口极小的本地 LLM

核心功能

• 撤销/重做集成 – 每次更改均可通过 Ctrl+Z 撤销。
• 智能类型解析 – 字符串如 "Vector2(100,200)" 或 "#ff0000" 会自动转换为 Godot 类型。
• 自动重连与心跳 – 具备容错连接处理能力。
• 有用的错误信息 – RPC 错误响应中包含下一步建议。
• CLI 回退 – 命令行客户端（cli.js）可在无 MCP 环境下驱动相同工具，适用于纯终端环境。

安装检查清单

1. 购买完整包（Buy Me a Coffee 或 itch.io）以获取 server/ 文件夹。
2. 将 addons/godot_mcp/ 目录复制到 Godot 项目中并启用插件。
3. 构建 Node 服务器（npm install && npm run build）。
4. 在 .mcp.json 中添加相应条目（根据需要选择模式标志）。
5. 启动 Godot，保持编辑器打开，运行你的 AI 助手。

许可与分发 – 本公开仓库中的插件代码为免费开源。MCP 服务器二进制文件和完整功能仅随付费包分发；仓库明确说明 server/ 目录未包含在公开仓库中。

---

Godot MCP Pro 是一款真正的 AI 导向工具，将大型语言模型与 Godot 游戏引擎连接起来，使开发者（或 AI 助手）能够以程序化、实时方式控制 Godot 项目的几乎所有方面。