hi-godot/godot-ai

解決的問題

Godot AI 允許 AI 助手（例如 Claude Code 或 Codex）直接與即時的 Godot 遊戲引擎編輯器互動。它消除了使用者在 AI 聊天與引擎之間手動複製貼上程式碼或場景設定的需要，讓 AI 能夠即時以程式化方式建構場景、編輯節點並設定遊戲環境。

工作原理

本專案使用 Model Context Protocol (MCP) 來連結 AI 客戶端與 Godot 編輯器。一個 Python 伺服器（使用 FastMCP）擔任中介，透過 WebSockets 與 Godot 編輯器外掛程式連接。AI 客戶端透過 HTTP 或 stdio 橋接與此伺服器通訊，從而觸發 43 個工具中的 120 多項操作，例如建立節點、連接訊號與編輯腳本。

適用對象

使用 Godot Engine（版本 4.5+）並希望利用 AI 代理自動化遊戲開發中繁瑣部分（如 UI 排版、場景組裝與基礎程式撰寫）的遊戲開發者。

主要亮點

• 深度編輯器整合：可程式化建構完整場景，設定材質、動畫、粒子與攝影機。
• 廣泛的客戶端支援：相容多種 MCP 客戶端，包括 Claude Code、Claude Desktop、Cursor 和 Zed。
• 完全由程式碼建構的 UI：無需外部影像生成，即可程式化繪製複雜 UI。
• 整合測試功能：內建編輯器內的 GDScript 測試框架，AI 客戶端可使用來撰寫與執行遊戲測試套件。