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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/ivanmurzakgodot-mcp.svg)](https://yunodb.com/tools/ivanmurzakgodot-mcp?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/ivanmurzakgodot-mcp?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/ivanmurzakgodot-mcp.svg" alt="Featured on YunoDB" height="20"></a>