프로젝트 소개

game-bridge-mcp는 AI 에이전트와 실행 중인 게임 인스턴스를 연결하기 위해 설계된 Model Context Protocol (MCP) 서버입니다. 이 서버는 에이전트가 게임 프로세스를 시작하고, 런타임에 사용 가능한 명령(도구)을 검색하며, 로컬 HTTP 표면을 통해 게임 상태와 상호작용할 수 있는 표준화된 인터페이스를 제공합니다. 이 브리지는 엔진에 구애받지 않으며, 상태 확인, 상태 스냅샷, 명령 실행 및 도구 매니페스트를 위한 엔드포인트를 포함한 최소한의 HTTP 계약만 게임 측에 요구합니다. 주요 기능으로는 충돌 방지를 위한 자동 포트 관리, 나란히 비교를 위해 여러 인스턴스를 동시에 구동하는 능력, 그리고 실행 중인 프로세스에서 게임의 명령 목록을 직접 가져오는 동적 도구 검색 메커니즘이 포함됩니다. 또한 완료 ID를 폴링하여 명령 동기화를 처리함으로써, 에이전트가 작업이 적용된 후에만 업데이트된 상태를 수신하도록 보장합니다. 이 프로젝트에는 Claude Code와 같은 MCP 클라이언트에 쉽게 등록할 수 있는 CLI가 포함되어 있으며, 프로젝트별 실행 파라미터를 위한 gamebridge.json 파일을 통한 설정을 지원합니다. 이는 독립형 CLI 도구로 사용하거나, 다른 프로젝트에 라이브러리로 통합하여 커스텀 복합 도구를 제공하도록 설계되었습니다.