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 | iex 2. 從 Godot 的 AssetLib 分頁或 GitHub 發行版將附加元件安裝到 your-project/addons/godot_ai/。3. 啟用它:專案 → 專案設定 → 外掛程式 → Godot AI。4. 連接你的客戶端:在 Godot AI 面板中,按下客戶端旁的「Configure」或「Configure all」。如果客戶端未注意到變更,請重新啟動它。

授權與價格

MIT 授權。開源且免費。

內容整理自該專案公開的 README 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

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

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