GodotMCP - Godot 引擎 MCP 对比 / 安装教程 / 游戏开发资源一站站

技能简介

GodotMCP 是面向独立游戏开发者的 Godot 引擎 MCP 资源一站站：把 GitHub 上分散的 Godot MCP 项目（Godot AI、Godot MCP Runtime、Full Control、Coding-Solo 等）按能力、引擎版本、环境要求、局限横向对比，并整理 Codex / Claude Code 等 AI 编程客户端接入 Godot MCP 的完整步骤，附带官方 Demo、Brackeys 教程源码、2D / 3D 资源等下载导航。让"AI Agent + Godot 做游戏"这件事从翻 GitHub 拼文档变成一次配置即可开干。

核心能力

1. MCP 项目横向对比：覆盖 Godot AI、Godot MCP Runtime、Full Control、Coding-Solo 等主流方案，逐项列出能力（编辑场景/修改脚本/运行游戏/截图/模拟输入）、适用场景、引擎版本要求、安装门槛与已知局限。
2. 客户端接入教程：分别整理 Codex 与 Claude Code 接入 Godot MCP 的完整步骤，含连接验证与常见问题排查清单。
3. 资源下载导航：当前收录 18 项资源——MCP 工具、Godot 官方 Demo（platformer.tscn 等）、Brackeys 教程源码、2D / 3D 素材，全部保留原项目地址。
4. 游戏开发入门：提供 2D / 3D 案例与源码拆解，帮助新手从现有项目开始，让 AI 辅助修改和开发。
5. 能力边界提示：明确哪些能力取决于 server / client / 引擎版本 / 权限，例如"读文件"和"检视 live scene"是两个不同的操作，让用户避免误判 MCP 能做什么。
6. 场景级 AI 工作流指引：从"识别一个 scene → 让 AI 改一个脚本 → 让 AI 跑起来抓截图"的完整闭环示例。
7. 错误排查示范：提供"先复现错误再让 AI 改一处"的正确姿势，避免 AI 修改后未回归验证的常见坑。
8. 多语言界面：英文 / 简体中文 / 日本語 三语切换。

安装配置

1. 选择 Godot 版本：新 GDScript 项目推荐 Godot 4.7.2 stable；老项目按自己需要锁定版本；模板 Standard 用 GDScript、.NET 模板用 C#。
2. 安装 AI 编程客户端：Codex 或 Claude Code 任选其一，按官方文档登录。
3. 选择 MCP 服务器：从 Godot AI（Godot 4.7+、uv/uvx）、Godot MCP Runtime、Full Control、Coding-Solo 等方案中选一个起步。
4. 以 Godot AI 为例：
   • 安装 Godot 4.7+ 与 uv。
   • 选定一个已发布的 Godot AI release，按其验证步骤跑一次。
   • 把 addon 放到项目 addons/godot_ai/ 并包含 plugin.cfg。
   • 在 Godot 编辑器 Project → Project Settings → Plugins 启用 Godot AI。
5. 客户端接入：在 Codex / Claude Code 中通过 stdio 接入 Coding-Solo Godot MCP，先做一次 read-only engine version check 验证链路。
6. 可选：公网部署：未来版本支持把 MCP server 暴露到公网，便于跨设备调试。

使用步骤

1. 打开一个能跑的项目：用 Godot 官方 platformer.tscn 之类现成 Demo 做起点，不要凭空改 AI 生成的样板。
2. 让 AI 做一个小改动：给 AI 一个明确的小目标，比如"把玩家跳跃高度从 360 改成 420"，让 AI 返回 diff。
3. 看 diff 再合并：在编辑器里看 AI 提出的改动，确认无误再合并到 scene/script。
4. 让 AI 跑起来：如果 MCP 支持 launch / debug，请求它启动 Godot 抓 launch output / 报错 / 截图；不支持则自己跑 Godot，把结果贴回对话。
5. 错误复现再让 AI 修：把完整错误信息和复现步骤发给 AI，让 AI 给一个聚焦 diff，应用后跑同一个回归用例确认。
6. 保持创作决策：MCP 是帮你更快做事的工具，不是替代设计 / 美术 / 玩法的代理——核心决策与最终验证仍在自己手上。

适用场景

• 独立游戏开发：个人或小团队做 2D / 3D 独立游戏，希望 AI 帮写 GDScript / 改 scene。
• AI 编程学习：让 Codex / Claude Code 真实地接入引擎 + 在编辑器中迭代。
• 教学场景：老师带学生从官方 Demo 起步，逐步让 AI 替代重复样板代码。
• 原型迭代：快速验证游戏机制、关卡设计、敌人 AI 行为树。
• 跨 Godot 项目迁移：从 Godot 3 升到 4.7 的项目，让 AI 做机械化的脚本语法升级。

适用人群

• 独立游戏开发者：想用 AI 加快 GDScript 编写与 scene 调整。
• AI 编程工具用户：希望 Codex / Claude Code 不止写代码还能操控引擎。
• Godot 新手：被 MCP 的零散生态卡住，需要一份中文社区整理的索引。
• 游戏开发教师：想给学生一个规范的"AI + Godot"入门路径。

工作原理

GodotMCP 把"AI 客户端 + MCP server + Godot 编辑器"三件套的选型与配置系统化整理：客户端层（Codex / Claude Code）通过 stdio / streamable HTTP 与 MCP server 通信；MCP server（如 Godot AI / Coding-Solo / Full Control）作为 Godot 的 GDExtension / 插件运行，向编辑器暴露 scene 节点、脚本、运行状态、错误日志等能力；Godot 编辑器负责最终渲染、运行、与人工审阅。MCP 选型差异决定 AI 能做到哪一步——读文件、检视 live scene、运行游戏抓截图是三种不同的能力，不能混为一谈。GodotMCP 把这些边界画清楚，避免用户对 MCP 能力有不切实际的预期。

官方链接

• 资源站：https://www.godotmcp.com
• 多语言入口：英文 / 简体中文 / 日本語