godot-mcp-bridge

godot-mcp-bridge

让 AI 助手全面访问 Godot 编辑器。

借助 Claude、Cursor 或任何兼容 MCP 的 AI，更快地构建游戏——无需复制粘贴，也无需切换上下文。AI 可直接在正在运行的 Godot 编辑器中读取、编写和操作场景、脚本、节点及项目设置。

Godot 4.5+ · 225 个工具（默认加载 35 个）· 支持撤销的实时场景树编辑 · 交互式项目可视化工具 · MIT 许可证

完整的工具说明、架构和设置指南，请参阅项目 README。此文件是展示在 npm 上的精简版本。

---

快速开始

1. 安装 Godot 插件

npx godot-mcp-bridge install

在 Godot 项目文件夹中运行——此命令会将插件复制到 addons/godot_mcp/ 并启用插件。或者，手动从 GitHub 仓库复制 addons/godot_mcp/，并在“项目设置”→“插件”中启用。（“Godot AI Assistant tools MCP” AssetLib 条目属于此分支所基于的上游项目，并非此仓库。）

2. 将服务添加到 AI 客户端

Claude Desktop / Cursor——添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-bridge"]
    }
  }
}

Windows：使用 "command": "cmd", "args": ["/c", "npx", "-y", "godot-mcp-bridge"]。

适用于任何兼容 MCP 的客户端（Claude Code、Cline、Windsurf 等）。

3. 连接

重启 AI 客户端，然后重启 Godot 项目。在编辑器右上角检查是否显示绿色的 MCP Connected。

---

它能做什么？

共有 225 个按意图分组的工具；默认只加载 core（35 个工具），让 Agent 保持专注。使用 enable_toolset({ name: "..." }) 可加载更多工具——包括运行时控制、场景编辑、项目配置、动画、物理、分析、脚手架、测试等。对编辑器中已打开场景的修改会通过实时场景树和 Godot 的撤销系统进行，而不是悄悄覆盖磁盘上的 .tscn 文件。

交互式可视化工具

运行 map_project，即可在 localhost:6510 打开基于浏览器的项目浏览器：

• 展示所有脚本及其关系的力导向图
• 点击任意脚本，即可查看变量、函数、信号和连接
• 直接在可视化工具中编辑代码——更改会实时同步到 Godot
• 支持节点属性编辑的场景视图
• 重构前查找用法

---

当前限制

• 仅限本地——在 localhost 上运行，不支持远程连接
• 单连接——一次只能连接一个 Godot 实例
• AI 对 Godot 的了解有限——它可以帮助调试、编写脚本和构建场景，但无法在没有指导的情况下创建完整游戏

---

从源代码构建

git clone https://github.com/TomasLucasUTN/godot-mcp-bridge
cd godot-mcp-bridge/mcp-server
npm install
npm run build

然后将 AI 客户端指向 mcp-server/dist/index.js，而不是使用 npx。

---

许可证

MIT

---

GitHub · 报告问题