Gbox MCP

🚀 GBox MCP 服務器

GBox MCP 服務器基於 FastMCP 協議實現，具備與 GBox 遊戲引擎即時通信和控制的能力。它能助力 AI 理解並操作 GBox 腳本，實現遊戲運行時的智能控制與資源管理。同時，通過與 ComfyUI 集成，可基於文本描述生成遊戲素材和圖像資源。

🚀 快速開始

GBox MCP 服務器能為您在 GBox 遊戲開發中帶來強大的功能支持。以下是使用前的準備和安裝步驟。

✨ 主要特性

• 🌟 基於 FastMCP 協議實現，保障通信高效穩定。
• 💪 幫助 AI 理解 GBox 腳本編程，實現對 GBox 遊戲運行時的精準控制。
• 🖼️ 與 ComfyUI 集成，支持直接在 GBox 應用中生成和處理圖像。

📦 安裝指南

克隆倉庫

請先克隆本項目的倉庫。

安裝依賴

在克隆好倉庫後，使用以下命令安裝所需依賴：

pip install -r requirements.txt

MCP 配置方法

在您的 MCP 客戶端配置中添加以下配置：

{
    "gbox": {
        "command": "python",
        "args": [
            "/path/to/gbox_mcp/gbox_mcp_server.py",
            "--gbox_ip", "gbox 運行時地址（ip:端口），例如 127.0.0.1:30080",
            "--comfyui_ip", "http://127.0.0.1:8188"
        ]
    }
}

配置說明：

• command：使用 python 執行服務器腳本。
• args：服務器腳本路徑和參數。
  • 第一個參數為服務器腳本的完整路徑。
  • --gbox_ip：設置服務器監聽的 GBox 地址（可選）。
  • --comfyui_ip：ComfyUI 服務器地址（可選），用於圖像生成和處理功能。

📚 詳細文檔

Gbox 遊戲引擎介紹

Gbox 是一個跨平臺的輕量級遊戲引擎，提供 2D/3D 圖形渲染、粒子特效系統、動畫系統、UI 界面開發、音頻處理、資源管理和腳本編程等功能，讓開發者能快速創建高質量遊戲和交互應用。

文檔鏈接

• Gbox API 文檔
• Gbox 語法文檔
• Gbox 語法示例

📄 許可證

本項目採用 MIT 許可證。詳見 LICENSE 文件。

🔧 技術細節

系統要求

• Python 3.6+
• FastMCP
• ComfyUI（用於圖像生成功能）