Godot Agent Loop

一個本機 MCP 伺服器，為 AI 助理提供 Godot 4 遊戲專案的完整循環：撰寫、執行、觀察、試玩與驗證。

可以做什麼

透過目錄與通用呼叫工具探索並執行隱藏能力，預設核心介面公開 16 個工具，完整目錄共 56 個（16 個核心加 40 個隱藏）。管理專案生命週期：執行、停止與測試 Godot 專案，包含原生、GUT 與 GdUnit4 測試執行器以及 .NET 建置流程。觀察執行中的遊戲：截圖、場景樹、UI、節點資訊、錯誤與日誌。以結構化情境與等待進行試玩，並提供滑鼠、鍵盤、觸控與遊戲手把等輸入原語。驅動編輯器工作階段並套用可復原的複合場景交易，以及透過有界斷言、匯出就緒檢查與完整性分析驗證專案。

適用情境

適合助理在建置、除錯或測試 Godot 4 遊戲專案時使用，需要啟動遊戲、觀察執行、模擬玩家輸入並檢查結果，而不只是編輯檔案。適用於具備算繪環境的桌面本機開發流程。

執行需求

透過 npx 以 stdio 在本機執行，需要 Node.js 22 或更新版本。需要 Godot Engine 4.7 或更新版本，可選設定 GODOT_PATH 指向執行檔。C# 專案可選需要 .NET SDK 8 與 Godot .NET 建置。執行遊戲與截圖需要桌面顯示或 Xvfb。可選的編輯器外掛需複製到專案並啟用，然後重新啟動 Godot。