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 repository。它與 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 套件）請見 Installation。

快速開始#

如果你熟悉終端機，以下指令可以讓一個 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」的要求。Getting started 頁面會逐步說明相同步驟並附上解釋，而本站的 quickstart 則涵蓋三個引擎。

本 wiki 的頁面#

• Installation：所有安裝方式（桌面應用程式、godot-cli、Asset Library、發行版 zip）以及所需的確切 NuGet 套件。
• Getting started：首次連線、第一次下指令，以及如何確認一切正常運作。
• Connecting AI clients：Cloud 端點與自架伺服器的差異、裝置登入、專案金鑰，以及各代理的 setup-mcp。
• Configuration：AI Game Developer 面板、已儲存的設定，以及 GODOT_MCP_* 環境變數。
• Tools：內建工具家族、RQL，以及各工具的用途。
• Custom tools：用 C# 撰寫自己的 MCP 工具，並從執行中的遊戲提供工具。
• Extensions：動畫、CSG、導覽、圖磚地圖與熱門 Godot 外掛的選用套件。
• godot-cli reference：所有 godot-cli 指令與其旗標。
• Troubleshooting：外掛無法載入、代理看不到工具、重新載入問題。
• FAQ：常見問題的簡短解答。

網站上的更多內容#

• Install Godot MCP：Godot 安裝頁面。
• Godot tools catalog 與 Godot extensions。
• Godot 最佳實務：如何撰寫效果良好的提示詞。
• MCP 端點與驗證：託管端點與登入的運作方式。
• AI Game Dev 應用程式 wiki，以及 Unity MCP 和 Unreal MCP 的 wiki。