Godot MCP

🚀 Godot MCP服務器配置指南

Godot MCP（Magic Command Processor）服務器是一款用於自動化和增強Godot遊戲引擎開發流程的工具。藉助MCP，你能夠讓AI助手直接執行與Godot項目相關的複雜操作，例如創建場景、添加節點、導出資源等。本指南將為你詳細介紹如何配置和使用Godot MCP服務器，並提供具體的實現細節和技術支持信息。

🚀 快速開始

下載與構建

1. 克隆代碼倉庫：

git clone https://github.com/yourusername/godot-mcp.git
cd godot-mcp

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

構建完成後，你會在build/目錄下找到可執行文件。

配置環境變量

• GODOT_PATH：指定Godot executable的路徑（可選）
• DEBUG：設置為"true"以啟用詳細日誌記錄

✨ 主要特性

• 可讓AI助手直接執行與Godot項目相關的複雜操作，如創建場景、添加節點、導出資源等。
• 採用特定架構，具有無臨時文件、簡化代碼維護、統一錯誤處理、減少I/O開銷等優勢。

📦 安裝指南

下載與構建

1. 克隆代碼倉庫：

git clone https://github.com/yourusername/godot-mcp.git
cd godot-mcp

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

構建完成後，可在build/目錄下找到可執行文件。

配置環境變量

• GODOT_PATH：指定Godot executable的路徑（可選）
• DEBUG：設置為"true"以啟用詳細日誌記錄

💻 使用示例

基礎用法

以下是一些使用場景的例子：

"啟動我在/path/to/project位置的遊戲項目"

"運行我的Godot項目並顯示任何錯誤信息"

"獲取我的Godot項目的結構信息"

"分析我的Godot項目結構並提供建議"

"幫我調試這個錯誤：[粘貼錯誤信息]"

"為我編寫一個帶有雙跳和滑牆功能的字符控制器腳本"

🔧 技術細節

架構設計

1. 直接命令：如啟動編輯器或獲取項目信息等簡單操作使用Godot的內置CLI命令。
2. GDScript腳本：複雜操作（如創建場景、添加節點）通過單個godot_operations.gd腳本實現。

這種架構的優勢：

• 無臨時文件
• 簡化代碼維護
• 統一錯誤處理
• 減少I/O開銷

📚 詳細文檔

故障排除

常見問題及解決方案：

📄 許可證

此項目使用MIT許可證，詳細信息請參閱LICENSE文件。