godot-ai
適用於 Godot 引擎的生產級 MCP 伺服器與 AI 工具。安裝簡單,完全免費且有趣。
godot-ai 是什麼?
適用於 Godot 引擎的生產級 MCP 伺服器與 AI 工具。安裝簡單,完全免費且有趣。
godot-ai 概覽
這是什麼
Godot AI 是一個生產級的 MCP(模型上下文協定)伺服器與 AI 工具組,專為 Godot 引擎設計。它能將 Claude Code、Codex、Cursor 等 MCP 客戶端連接到正在執行的 Godot 編輯器。該專案提供 46 個工具與超過 120 項操作,可用於建立場景、編輯節點與腳本、連接訊號,以及設定 UI、材質、動畫、粒子、攝影機與環境。它以 Snap 形式發行,並採用 MIT 授權的開源軟體。
主要功能
- 46 個工具與 120+ 項操作,涵蓋場景建立、節點與腳本編輯、訊號連接,以及 UI、材質、動畫、粒子、攝影機與環境的設定。
- 完整支援 GDScript(語法驗證、熱重載、附加、大綱),C# 僅支援文字模式(script_create/script_patch 寫入 .cs 檔案,script_manage 可產生大綱,但不建置 .NET 或回報編譯錯誤)。
- 經過驗證的本機連線:伺服器與編輯器僅接受出示輪換憑證的連線,編輯器連線僅限迴路(loopback)。
- 簽署版本發行,內建編輯器更新器會在安裝前驗證簽章與每個檔案。
- 專案隔離:寫入操作僅限於專案目錄內,且 project.godot、override.cfg 與 .godot/ 目錄受到保護。
- 匿名遙測記錄安裝 UUID、事件、結果、持續時間、平台與版本(絕不記錄程式碼、場景內容或專案/檔案名稱);可透過環境變數或編輯器設定選擇退出。
使用情境
- 使用 MCP 客戶端以自然語言提示快速建立與迭代 Godot 遊戲場景與 UI。
- 自動化重複的編輯器任務,例如建立節點、附加腳本、連接訊號,以及設定材質與動畫。
- 直接從 AI 客戶端執行遊戲的測試套件。
- 從少量提示建立完整的遊戲原型(例如包含玩家、方塊與存檔欄位的體素方塊世界遊戲)。
快速開始
你需要 Godot 4.7+、uv 以及一個 MCP 客戶端。1. 安裝 uv(僅需一次):
- macOS/Linux:
sh curl -LsSf https://astral.sh/uv/install.sh | sh - Windows(PowerShell):
powershell irm https://astral.sh/uv/install.ps1 | iex2. 從 Godot 的 AssetLib 分頁或 GitHub 發行版將附加元件安裝到 your-project/addons/godot_ai/。3. 啟用它:專案 → 專案設定 → 外掛程式 → Godot AI。4. 連接你的客戶端:在 Godot AI 面板中,按下客戶端旁的「Configure」或「Configure all」。如果客戶端未注意到變更,請重新啟動它。
授權與價格
MIT 授權。開源且免費。
內容整理自該專案公開的 README 與儲存庫資訊。