本页由英文机器翻译而成。阅读英文原文。

引擎 · Godot

Godot可用

把 godot_mcp 插件添加到你的 C# Godot 项目,用 AI 驱动编辑器。

Godot 4.3–4.5C# / .NET 8 (mono)
01

安装插件

两种方式把插件装进你的项目——选适合你工作流的那种。

推荐

CLI

通过 npm 上的 godot-cli 工具安装。install-plugin 会从匹配的 GitHub Release 下载 godot_mcp 插件,向你的 .csproj 添加两个 NuGet 包和扩展目录嵌入资源,并启用插件——整个过程是幂等的。

1安装 CLI

从 npm 全局安装 godot-cli。

npm install -g godot-cli
2安装插件

下载插件,将 NuGet 包添加到你的 .csproj,并在 project.godot 中启用 godot_mcp。

godot-cli install-plugin ./MyGodotProject
3接入你的 AI 客户端

为你的客户端生成 MCP 配置(例如 Claude Code)。

godot-cli setup-mcp claude-code ./MyGodotProject
4打开并等待

打开项目并等待编辑器就绪。

godot-cli open ./MyGodotProject

打开后,你还可以根据编辑器就绪状态来控制脚本是否运行:godot-cli wait-for-ready ./MyGodotProject。

资源库

从 Godot 资源库安装 godot_mcp 插件(或从 GitHub Releases 下载同一个 zip),然后添加两个 NuGet 包并启用插件。

在资源库中查看
1安装插件

从 Godot 的 AssetLib 标签页获取 godot_mcp,或从 GitHub Releases 页面下载 zip,并将其放入项目的 addons/ 文件夹。

2添加 NuGet 包

将两个包都添加到你的项目 .csproj:com.IvanMurzak.ReflectorNet 版本 5.4.3 和 com.IvanMurzak.McpPlugin 版本 8.7.1,以及 addons/godot_mcp/extensions.catalog.json EmbeddedResource(没有它,扩展面板会为空)。确切内容见 Godot-MCP README。

3启用插件

在编辑器中打开 Project → Project Settings → Plugins,然后启用 godot_mcp。

4打开并构建

重新打开项目,让 Godot 使用新包构建 C# 解决方案。

02

连接

通过托管的云端端点运行,或指向你自己的服务器。

云端

默认

使用设备码 OAuth 流程通过 ai-game.dev 连接——无需手动复制令牌。在 AI Game Developer 窗口中选择 Cloud,点击 Authorize,然后在浏览器中批准设备码。可跨防火墙使用,并提供用量分析。这是默认方式,也是我们为大多数用户推荐的方式。

自定义

更想全部在本地运行?把插件指向你自己的 gamedev-mcp-server 实例,而不是托管端点。这样你的 AI 客户端会直接与本机通信。各客户端的配置片段见 MCP 端点页面。

需要客户端配置片段(Claude、Cursor、Copilot、Gemini 等)?查看 MCP 端点页面 →

03

配置你的 AI 智能体

选择你使用的 AI 智能体,复制把它接入 Godot MCP 服务器的 godot-cli 命令。

你的 AI 智能体

在你的项目中运行以下命令,为 Godot 配置 Claude Code:

godot-cli setup-mcp claude-code ./MyGodotProject

配置后请重启你的智能体。新的 MCP 服务器只有在智能体完全重启后才会被加载——请彻底退出并重新打开(仅重载窗口不够)。

04

首次运行

打开窗口,完成授权,然后试试你的第一条提示词。

  1. 在 Godot 编辑器中打开项目,并打开 AI Game Developer 停靠面板。
  2. 选择 Cloud 并点击 Authorize,完成设备码流程。
  3. 等待状态变为绿色,然后连接你的 AI 客户端。
  4. 试试下面这样的提示词,看它在编辑器里如何执行。
示例提示词
添加一个包含 Camera3D 和 MeshInstance3D 立方体的 Node3D 场景,然后将其保存为 Main.tscn。

想要更多示例提示词和高效 AI 请求的写作范式?查看 Godot 最佳实践 →

Godot 插件为你的 AI 客户端提供 99 个 MCP 工具。

浏览 Godot 工具目录 →

想要更多工具?浏览 Godot 扩展 →