面向 Godot 4 的 AI 驱动游戏开发 MCP 服务器，通过 WebSocket 实时桥接 AI 助手与 Godot 编辑器，提供 172 个工具覆盖场景搭建、节点管理、运行时调试、自动化测试与跨平台部署。
Godot MCP Pro 通过 Model Context Protocol 将 Claude Code、Cursor、Cline 等 AI 编程助手直接连接到 Godot 4 编辑器，实现自然语言驱动的游戏开发工作流。项目采用三层桥接架构：AI 助手通过 stdio/MCP 协议与 Node.js MCP Server 通信，MCP Server 再通过 WebSocket（JSON-RPC 2.0）连接 Godot 编辑器插件（GDScript），最终调用 Godot 编辑器 API 执行操作。
核心能力#
- 172 个 MCP 工具（Full 模式），覆盖 25+ 分类：项目管理、场景树、节点属性、脚本、动画、TileMap、Shader、物理、3D 场景、粒子系统、导航、音频、导出部署等
- UndoRedo 集成：所有节点/属性操作支持 Ctrl+Z 撤销
- 智能类型解析：自动将
"Vector2(100, 200)"、"#ff0000"、"Color(1,0,0)"等字符串转换为 Godot 原生类型 - 批量重构：跨场景批量修改属性、查找节点引用、检测循环依赖
连接与通信#
- 实时 WebSocket 连接（默认端口 6505），即时反馈无文件轮询
- 指数退避自动重连（1s → 2s → 4s → … → 60s max）
- 10s ping/pong 心跳保活
- JSON-RPC 2.0 标准协议，含正确错误码与建议
运行时能力#
- 游戏输入模拟（键盘、鼠标、Godot Input Action）与录制回放
- 性能监控：FPS、内存、物理等指标实时获取
- 编辑器视口与运行中游戏截图
- 节点状态断言、屏幕文本检测、截图对比、压力测试等 QA 功能
- Android 一键远程部署（导出 → adb install → 启动）
模式与配置#
四种运行模式适配不同 AI 客户端工具数量限制：Full（172 工具）、3D（100）、Lite（81）、Minimal（35）。CLI 模式支持无 MCP 协议的客户端通过终端直接调用，通过 --help 渐进式发现可用命令。配置仅需设置 GODOT_MCP_PORT 环境变量（默认 6505，支持自动扫描 6505–6509）和启动模式标志。
客户端兼容性#
| 客户端 | 推荐模式 |
|---|---|
| Claude Code | Full |
| VS Code Copilot | Full |
| Cline | Full |
| Cursor | Full |
| Windsurf | Lite |
| Gemini CLI | Lite |
| OpenCode / 本地 LLM | Minimal/CLI |
分发与许可模式#
Godot 插件部分（addons/godot_mcp/）在 GitHub 以 MIT 开源；MCP Server 部分（TypeScript/Node.js）为专有许可，需一次性付费 $5 获取预构建包（含终身更新）。公开仓库仅包含插件代码，MCP Server 源码可见性待确认。
待确认事项#
- 付费包是否附带 TypeScript 源码（README 仅提及 pre-built JavaScript）
- Windsurf、JetBrains Junie 等客户端兼容性基于社区反馈，非官方认证
- Godot 4 具体子版本兼容范围未明确
- 运行时 IPC 文件格式与并发安全机制未说明