Sobre o projeto

O game-bridge-mcp é um servidor Model Context Protocol (MCP) projetado para fazer a ponte entre agentes de IA e instâncias de jogos em execução. Ele fornece uma interface padronizada para que os agentes iniciem processos de jogos, descubram comandos disponíveis (ferramentas) em tempo de execução e interajam com o estado do jogo através de uma superfície HTTP local. A ponte é agnóstica ao motor, exigindo apenas um contrato HTTP mínimo do jogo, incluindo endpoints para verificações de integridade, snapshots de estado, execução de comandos e manifestos de ferramentas. As principais capacidades incluem o gerenciamento automático de portas para evitar colisões, a habilidade de operar múltiplas instâncias simultaneamente para comparações lado a lado e um mecanismo de descoberta dinâmica de ferramentas que busca a lista de comandos do jogo diretamente do processo em execução. Ele também gerencia a sincronização de comandos por meio de polling de IDs de conclusão, garantindo que os agentes recebam o estado atualizado somente após a aplicação das ações. O projeto inclui uma CLI para fácil registro em clientes MCP como o Claude Code e suporta configuração via arquivo gamebridge.json para parâmetros de lançamento específicos do projeto. Ele foi projetado para ser usado como uma ferramenta CLI independente ou integrado a outros projetos como uma biblioteca para fornecer ferramentas compostas personalizadas.