# Godot — AI Game Developer

为 Godot 4.3–4.5（C# / .NET 8）安装 AI Game Developer 扩展。两种安装方式——Asset Library / GitHub Release 和 godot-cli——以及如何连接你的 AI 客户端并运行第一条提示词。

本页由英文机器翻译而成。[阅读英文原文](https://ai-game.dev/engines/godot)。

引擎 · Godot

把 godot\_mcp 插件添加到你的 C# Godot 项目，用 AI 驱动编辑器。

Godot 4.3–4.5 C# / .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 包并启用插件。

[在资源库中查看](https://godotengine.org/asset-library/asset/5245)

1 安装插件

从 Godot 的 **AssetLib** 标签页获取 `godot_mcp`，或从 [GitHub Releases](https://github.com/IvanMurzak/Godot-MCP/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](https://github.com/IvanMurzak/Godot-MCP/blob/main/README.md)。

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 端点页面](https://ai-game.dev/mcp-endpoint-info)。

需要客户端配置片段（Claude、Cursor、Copilot、Gemini 等）？[查看 MCP 端点页面 →](https://ai-game.dev/mcp-endpoint-info)

03

## 配置你的 AI 智能体

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

你的 AI 智能体

**Claude Code**

在你的项目中运行以下命令，为 Godot 配置 **Claude Code**：

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

**Claude Desktop**

在你的项目中运行以下命令，为 Godot 配置 **Claude Desktop**：

`godot-cli setup-mcp claude-desktop ./MyGodotProject`

**Cursor**

在你的项目中运行以下命令，为 Godot 配置 **Cursor**：

`godot-cli setup-mcp cursor ./MyGodotProject`

**VS Code (Copilot)**

在你的项目中运行以下命令，为 Godot 配置 **VS Code (Copilot)**：

`godot-cli setup-mcp vscode-copilot ./MyGodotProject`

**Visual Studio (Copilot)**

在你的项目中运行以下命令，为 Godot 配置 **Visual Studio (Copilot)**：

`godot-cli setup-mcp vs-copilot ./MyGodotProject`

**GitHub Copilot CLI**

在你的项目中运行以下命令，为 Godot 配置 **GitHub Copilot CLI**：

`godot-cli setup-mcp github-copilot-cli ./MyGodotProject`

**Codex**

在你的项目中运行以下命令，为 Godot 配置 **Codex**：

`godot-cli setup-mcp codex ./MyGodotProject`

**Gemini**

在你的项目中运行以下命令，为 Godot 配置 **Gemini**：

`godot-cli setup-mcp gemini ./MyGodotProject`

**Cline**

在你的项目中运行以下命令，为 Godot 配置 **Cline**：

`godot-cli setup-mcp cline ./MyGodotProject`

**Rider (Junie)**

在你的项目中运行以下命令，为 Godot 配置 **Rider (Junie)**：

`godot-cli setup-mcp rider-junie ./MyGodotProject`

**Kilo Code**

在你的项目中运行以下命令，为 Godot 配置 **Kilo Code**：

`godot-cli setup-mcp kilo-code ./MyGodotProject`

**Open Code**

在你的项目中运行以下命令，为 Godot 配置 **Open Code**：

`godot-cli setup-mcp open-code ./MyGodotProject`

**Antigravity**

在你的项目中运行以下命令，为 Godot 配置 **Antigravity**：

`godot-cli setup-mcp antigravity ./MyGodotProject`

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

04

## 首次运行

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

1. 在 Godot 编辑器中打开项目，并打开 **AI Game Developer** 停靠面板。
2. 选择 **Cloud** 并点击 **Authorize**，完成设备码流程。
3. 等待状态变为绿色，然后连接你的 AI 客户端。
4. 试试下面这样的提示词，看它在编辑器里如何执行。

示例提示词

```text
添加一个包含 Camera3D 和 MeshInstance3D 立方体的 Node3D 场景，然后将其保存为 Main.tscn。
```

想要更多示例提示词和高效 AI 请求的写作范式？[查看 Godot 最佳实践 →](https://ai-game.dev/docs/best-practices/godot)

[Godot 插件为你的 AI 客户端提供 **99 个 MCP 工具**。](https://ai-game.dev/docs/tools/godot)

浏览 Godot 工具目录 →

想要更多工具？[浏览 Godot 扩展 →](https://ai-game.dev/docs/extensions/godot)

---

Source (HTML): https://ai-game.dev/zh-hans/engines/godot

Machine-translated (zh-Hans) from the English page: https://ai-game.dev/engines/godot