このプロジェクトについて

game-bridge-mcpは、AIエージェントと実行中のゲームインスタンスを橋渡しするために設計されたModel Context Protocol (MCP) サーバーです。エージェントがゲームプロセスの起動、実行時の利用可能なコマンド（ツール）の検出、およびローカルHTTPサーフェスを介したゲーム状態との対話を行うための標準化されたインターフェースを提供します。このブリッジはエンジンに依存せず、ヘルスチェック、状態スナップショット、コマンド実行、ツールマニフェストのためのエンドポイントを含む、ゲーム側からの最小限のHTTPコントラクトのみを必要とします。主な機能には、衝突を防ぐための自動ポート管理、並行比較のための複数インスタンスの同時駆動能力、および実行中のプロセスからゲームのコマンドリストを直接取得する動的ツール検出メカニズムが含まれます。また、完了IDをポーリングしてコマンドの同期を処理し、アクションが適用された後にのみエージェントが更新された状態を受信することを保証します。本プロジェクトには、Claude CodeなどのMCPクライアントへの簡単な登録を可能にするCLIが含まれており、プロジェクト固有の起動パラメータについてはgamebridge.jsonファイルによる設定をサポートしています。スタンドアロンのCLIツールとして使用することも、カスタム複合ツールを提供するためにライブラリとして他のプロジェクトに統合することも可能です。