Gbox MCP

🚀 GBox MCP サーバー

GBox MCP サーバーは、FastMCP プロトコルに基づくサーバー実装です。GBox ゲームエンジンとのリアルタイム通信と制御機能を提供します。これにより、AI が GBox スクリプトを理解し操作することができ、ゲーム実行時のインテリジェントな制御とリソース管理を実現します。また、ComfyUI との統合により、テキスト記述に基づくゲーム素材や画像リソースの生成もサポートしています。

🚀 クイックスタート

GBox MCP サーバーは、FastMCP プロトコルに基づいて構築され、GBox ゲームエンジンとの通信を可能にします。これにより、AI がゲームの実行時にスクリプトを操作し、リソースを管理することができます。また、ComfyUI との統合により、画像生成機能も提供します。

✨ 主な機能

• FastMCP プロトコルに基づく実装
• AI が GBox スクリプトを理解し、GBox ゲームの実行時を制御するのを支援
• ComfyUI との統合により、GBox アプリ内での画像生成と処理をサポート

📦 インストール

依存関係のインストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

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（画像生成機能に必要）