Godot MCP

Godot MCP 是 AI Game Developer 的 Godot 插件。它让 Claude Code、Cursor、GitHub Copilot、Codex 或 Gemini 等 AI 代理在 Godot 编辑器内工作：查询和编辑场景树、打开和保存 .tscn 场景、修改 .tres 资源和项目设置、读写 C# 和 GDScript 文件、构建 C# 项目、在编辑器中运行 C# 代码片段，以及截取模型可以查看的屏幕截图。本 wiki 介绍如何安装它、连接 AI 客户端，以及日常如何使用它。

Godot MCP 是什么#

Godot MCP 是一个 C# 编辑器插件（文件夹 addons/godot_mcp/，在 Project Settings 中显示为 Godot-MCP），运行在 Godot 4 .NET 项目中。编辑器加载它时，该插件会打开一个名为 AI Game Developer 的停靠面板，并连接到 MCP 服务器。与你对话的 AI 代理连接到同一个服务器，并通过 Model Context Protocol (MCP) 调用该插件的工具。

该插件是开源的（Apache-2.0），位于 Godot-MCP 仓库。它与 Unity MCP 和 Unreal MCP 共用 MCP 与反射库，因此三个引擎插件的行为方式一致，并使用同一个云账户。

各部分如何协同工作#

在默认的 Cloud 模式下，除了 Godot 和你的 AI 客户端之外，你的机器上不会运行任何东西：编辑器和代理都连接到托管端点，你只需用 ai-game.dev 账户登录一次。在 Custom 模式下，插件可以为你下载并启动本地 MCP 服务器，因此一切都留在你自己的电脑上。

环境要求一览#

• Godot 4.3 或更新版本的 .NET（mono）构建版。仅支持 GDScript 的标准版本无法编译该插件。
• .NET 8 SDK。
• 带有 C# .csproj 的 Godot 项目。你自己的游戏代码仍然可以是 GDScript；插件只需要 C# 项目来编译自身。
• 一个支持 MCP 的 AI 客户端。

完整清单（包括你的 .csproj 所需的 NuGet 包）见 安装。

快速开始#

如果你习惯使用终端，以下命令可以让一个 Godot C# 项目从零开始连接到 AI 代理：

npm install -g godot-cli
godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject

然后向你的代理发出类似“添加一个包含 Camera3D 和 MeshInstance3D 立方体的 Node3D 场景，然后将其保存为 Main.tscn”的指令。入门 页面会附带说明逐步讲解相同的步骤，本站的 快速开始 则涵盖全部三个引擎。

本 wiki 的页面#

• 安装：所有安装方式（桌面应用、godot-cli、Asset Library、发布压缩包）以及所需的具体 NuGet 包。
• 入门：首次连接、最初的提示词，以及如何检查一切是否正常。
• 连接 AI 客户端：Cloud 端点与自建服务器的区别、设备登录、项目密钥，以及针对每种代理的 setup-mcp。
• 配置：AI Game Developer 停靠面板、已保存的设置和 GODOT_MCP_* 环境变量。
• 工具：内置的工具系列、RQL，以及每个工具的用途。
• 自定义工具：用 C# 编写你自己的 MCP 工具，并从正在运行的游戏暴露工具。
• 扩展：用于动画、CSG、导航、瓦片地图和热门 Godot 插件的可选包。
• godot-cli 参考：所有 godot-cli 命令及其参数。
• 故障排查：插件无法加载、代理看不到任何工具、重新加载问题。
• 常见问题：对常见疑问的简短解答。

站点上的更多内容#

• 安装 Godot MCP：Godot 安装页面。
• Godot 工具目录 和 Godot 扩展。
• Godot 最佳实践：如何编写有效的提示词。
• MCP endpoint 与身份验证：托管端点以及登录的工作方式。
• AI Game Dev 应用 wiki，以及 Unity MCP 和 Unreal MCP 的 wiki。