JinDaGe - gbox_mcp MCP Details

article

README

🚀 GBox MCP 服务器

GBox MCP 服务器基于 FastMCP 协议实现，具备与 GBox 游戏引擎实时通信和控制的能力。它能助力 AI 理解并操作 GBox 脚本，实现游戏运行时的智能控制与资源管理。此外，通过与 ComfyUI 集成，可基于文本描述生成游戏素材和图像资源。

🚀 快速开始

GBox MCP 服务器能帮助开发者实现游戏运行时的智能控制和资源管理，还能借助 ComfyUI 生成图像资源。以下是使用前的准备工作：

Python 3.6+
FastMCP
ComfyUI（用于图像生成功能）

✨ 主要特性

协议实现：基于 FastMCP 协议实现。
AI 支持：帮助 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 界面开发、音频处理、资源管理和脚本编程，让开发者能快速创建高质量游戏和交互应用。

文档链接

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

gbox_mcp