Godot-MCP
Godot Engine 的 MCP 整合方案 — 模型上下文協定 (MCP) 整合。使用 C# 為 Godot 編輯器提供 AI 工具,支援雲端連線至 ai-game.dev。Apache-2.0 授權。
Godot-MCP 是什麼?
Godot-MCP — 在 Godot Engine 中整合模型上下文協定 (MCP)。提供用 C# 開發的 AI 工具,並可連線至 ai-game.dev 雲端服務。採用 Apache-2.0 授權條款。
Godot-MCP 概覽
這是什麼
Godot-MCP 是一個為 Godot 引擎編輯器設計的 AI 驅動遊戲開發輔助工具。它整合了模型上下文協定 (MCP),讓 Claude、Cursor 或 Copilot 等 AI 代理能夠檢查和控制 Godot 專案。此插件以 C# 撰寫,可連線至 ai-game.dev 的雲端後端或自架伺服器。它是 Unity-MCP 的 Godot 對應版本,並透過 NuGet 套件共用相同的 MCP/反射堆疊。本專案採用 Apache-2.0 授權。
主要功能
- 內建 23 個 MCP 工具,分屬 9 個系列,包含 RQL(反射查詢語言)用於查詢和修改場景、節點、資源及編輯器狀態。
- 支援讀取、建立、更新和刪除 C# (.cs) 與 GDScript (.gd) 腳本,並可將腳本附加至節點。
- 透過視埠、攝影機和獨立節點截圖提供視覺回饋,回傳 PNG 影像。
- 可透過
CallMethod呼叫任何 Godot 方法(包含 GDScript 方法);在遊戲執行中,可透過 ReflectorNet 尋找並呼叫 C# 方法。 - 可立即連線至 ai-game.dev 雲端,或指向自訂的自架伺服器。
- 提供 CLI 工具 (
godot-cli) 用於專案建立、插件安裝、登入及 MCP 設定。
使用情境
- AI 輔助場景建立與編輯,例如生成節點並在場景樹中排列。
- 自動化腳本管理,包括讀取、寫入腳本並附加至節點。
- 在執行階段偵錯與檢查遊戲狀態,透過擷取日誌、呼叫方法及截圖。
- 快速原型開發,透過與 AI 代理對話直接操作 Godot 編輯器。
快速開始
bash# 1. 安裝 godot-clinpm install -g godot-cli# 2. (選擇性) 建立新的 Godot C# 專案godot-cli create-project --dotnet ./MyGodotProject# 3. 安裝 godot_mcp 插件godot-cli install-plugin ./MyGodotProject# 4. 登入 ai-game.dev 雲端godot-cli login# 5. 為 AI 代理(例如 Claude Code)設定 MCPgodot-cli setup-mcp claude-code ./MyGodotProject# 6. 開啟 Godot 編輯器godot-cli open ./MyGodotProject# 7. 等待插件就緒godot-cli wait-for-ready ./MyGodotProject
授權與價格
本專案為開放原始碼,採用 Apache-2.0 授權。未提及價格資訊。
內容整理自該專案公開的 README 與儲存庫資訊。