# Godot — AI Game Developer

為 Godot 4.3–4.5（C# / .NET 8）安裝 AI Game Developer 附加元件。兩種安裝方式 — 資產庫 / GitHub 發行版與 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 外掛、把兩個 NuGet 套件與擴充功能目錄內嵌項目加入你的 .csproj，並啟用外掛——重複執行也不會出問題。

1 安裝 CLI

從 npm 全域安裝 godot-cli。

`npm install -g godot-cli`

2 安裝外掛

下載外掛、把 NuGet 套件加入你的 .csproj，並在 project.godot 中啟用 godot\_mcp。

`godot-cli install-plugin ./MyGodotProject`

3 接好你的 AI 用戶端

為你的用戶端（例如 Claude Code）產生 MCP 設定。

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

4 開啟並等待

開啟專案，並等待編輯器就緒。

`godot-cli open ./MyGodotProject`

開啟後，你還可以讓腳本等到編輯器就緒再執行：`godot-cli wait-for-ready ./MyGodotProject`。

### 素材庫

從 Godot Asset Library 安裝 godot\_mcp 外掛（或從 GitHub Releases 取得同一個 zip），然後加入兩個 NuGet 套件並啟用外掛。

[在 Asset Library 查看](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（少了它，Extensions 面板會是空的）。完整的設定區塊請見 [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-hant/engines/godot

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