Gbox MCP

🚀 GBox MCP Server

The GBox MCP Server is an implementation based on the FastMCP protocol, offering real - time communication and control capabilities with the GBox game engine. It enables AI to understand and manipulate GBox scripts, achieving intelligent control and resource management during game runtime. Additionally, through integration with ComfyUI, it supports generating game materials and image resources based on text descriptions.

🚀 Quick Start

The GBox MCP Server is an implementation based on the FastMCP protocol. It provides real - time communication and control capabilities with the GBox game engine, helping AI understand and operate GBox scripts for intelligent control and resource management during game runtime. Moreover, it supports generating game materials and image resources based on text descriptions through integration with ComfyUI.

✨ Features

• Implemented based on the FastMCP protocol.
• Helps AI understand GBox script programming and provides control over the GBox game runtime.
• Integrates with ComfyUI, supporting image generation and processing directly in GBox applications.

📦 Installation

1. Clone the repository.
2. Install dependencies:

pip install -r requirements.txt

MCP Configuration Method

Add the following configuration to your MCP client configuration:

{
    "gbox": {
        "command": "python",
        "args": [
            "/path/to/gbox_mcp/gbox_mcp_server.py",
            "--gbox_ip", "The running address (ip:port) of GBox, e.g., 127.0.0.1:30080",
            "--comfyui_ip", "http://127.0.0.1:8188"
        ]
    }
}

Configuration details:

• command: Use Python to execute the server script.
• args: The path and parameters of the server script.
  • The first parameter is the full path of the server script.
  • --gbox_ip: Set the GBox address that the server listens to (optional).
  • --comfyui_ip: The address of the ComfyUI server (optional), used for image generation and processing functions.

📚 Documentation

Introduction to the Gbox Game Engine

Gbox is a cross - platform lightweight game engine that provides 2D/3D graphics rendering, particle effect systems, animation systems, UI interface development, audio processing, resource management, and script programming, allowing developers to quickly create high - quality games and interactive applications.

Documentation Links

• Gbox API Documentation
• Gbox Syntax Documentation
• Gbox Syntax Example

🔧 Technical Details

System Requirements

• Python 3.6+
• FastMCP
• ComfyUI (for image generation functionality)

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.