Godot MCP Pro 是一款面向 AI 辅助 Godot 4 游戏开发的 MCP（Model Context Protocol）服务器，用于将 Claude 等 AI 助手直接连接到 Godot 编辑器。其公开仓库仅包含免费的 Godot 插件（addon），而连接 AI 助手所必需的 MCP 服务器（Node.js）属于付费包的一部分，采用一次性购买、终身更新的方式分发。
用途与定位 该工具旨在让 AI 助手能够实时操作 Godot 编辑器，覆盖从场景搭建、脚本编写到运行时调试的完整开发流程。它通过 WebSocket 连接实现即时反馈，无需文件轮询；并完整接入 Godot 的编辑器 API、UndoRedo 系统与场景树。
主要能力 官方资料列出了 187 个工具（标题中亦提及 162 个 MCP 工具），涵盖以下类别：项目工具（10）、场景工具（10）、节点工具（17）、脚本工具（9）、编辑器工具（15）、输入工具（5）、输入映射工具（2）、运行时工具（20）、动画工具（6）、TileMap 工具（6）、主题与 UI 工具（8）、性能分析工具（2）、批量与重构工具（7）、着色器工具（6）、导出工具（4）、资源工具（4）、物理工具（6）、3D 场景工具（7）、粒子工具（5）、导航工具（5）、音频工具（6）、AnimationTree 工具（9）、分析与搜索工具（6）、测试与 QA 工具（6）、无头工具（3）、Android 工具（3）。此外还具备 UndoRedo 集成（所有节点/属性操作支持 Ctrl+Z）、智能类型解析（如 "Vector2(100, 200)"、"#ff0000"、"Color(1,0,0)" 自动转换）、自动重连（指数退避 1s→2s→4s…最长 60s）、心跳保活（10 秒 ping/pong）以及带建议的错误响应。
使用方式
- 安装 Godot 插件：将 addons/godot_mcp/ 文件夹复制到 Godot 项目的 addons/ 目录，然后在 项目 → 项目设置 → 插件 中启用 Godot MCP Pro。
- 安装 MCP 服务器：server/ 目录仅包含在完整付费包中，下载解压后运行相应命令。
- 配置 Claude Code：在 .mcp.json 中添加配置。
- 选择模式：提供四种模式以适应不同客户端的工具数量限制。--3d 包含核心工具以及物理、AnimationTree 和导航，但省略 uid_to_project_path、project_path_to_uid、compare_screenshots、clear_output、close_script、reload_open_scripts、set_anchor_preset 和 click_button_by_text，以保持在 100 个工具上限内；将 --lite 替换为 --minimal 可获得最小占用。Lite 包含 project、scene、node、script、editor、input、runtime 和 input_map 工具；Minimal 包含 35 个基本工具——项目信息、场景管理、节点 CRUD、脚本编辑、编辑器错误、输入模拟和运行时检查。
- CLI 模式（MCP 的替代方案）：适用于不支持 MCP 的客户端，或希望零上下文开销的场景，可直接从终端/bash 工具使用 CLI。CLI 需要先构建服务器（步骤 2），并直接通过 WebSocket 连接到 Godot 编辑器插件，要求：Godot 编辑器运行并启用 MCP 插件、服务器已构建（node build/setup.js install）、6510-6514 范围内有可用端口。其优势在于 LLM 可通过 --help 逐步发现能力，而不是预先加载所有工具定义，适用于任何具有终端访问权限的 LLM 客户端，不受工具数量限制。
- 客户端兼容性：打开启用了插件的 Godot 项目，然后使用 Claude Code 与编辑器交互。
适用场景 适用于使用 Godot 4 进行游戏开发、并希望借助 AI 助手完成场景编辑、脚本编写、动画、TileMap、着色器、输入模拟、运行时分析、导航、测试等任务的开发者。
限制与说明 公开仓库仅包含免费的 Godot 插件，MCP 服务器需通过付费包获取（一次性购买，约 15 美元，含终身更新），购买渠道包括 Buy Me a Coffee 和 itch.io。若克隆仓库后没有 server/ 文件夹，属于正常情况。该软件为专有软件，具体许可条款见 LICENSE。CLI 模式需要 Godot 编辑器运行、服务器已构建且端口可用。
