Sobre el proyecto

game-bridge-mcp es un servidor Model Context Protocol (MCP) diseñado para conectar agentes de IA con instancias de juegos en ejecución. Proporciona una interfaz estandarizada para que los agentes inicien procesos de juego, descubran comandos disponibles (herramientas) en tiempo de ejecución e interactúen con el estado del juego a través de una superficie HTTP local. El puente es agnóstico al motor, requiriendo solo un contrato HTTP mínimo por parte del juego, que incluya endpoints para comprobaciones de estado (health checks), instantáneas de estado, ejecución de comandos y manifiestos de herramientas. Las capacidades clave incluyen la gestión automática de puertos para evitar colisiones, la capacidad de manejar múltiples instancias simultáneamente para comparaciones paralelas y un mecanismo de descubrimiento dinámico de herramientas que obtiene la lista de comandos del juego directamente desde el proceso en ejecución. También gestiona la sincronización de comandos mediante la consulta de IDs de finalización, asegurando que los agentes reciban el estado actualizado solo después de que se hayan aplicado las acciones. El proyecto incluye una CLI para facilitar el registro con clientes MCP como Claude Code y admite la configuración mediante un archivo gamebridge.json para parámetros de lanzamiento específicos del proyecto. Está diseñado para utilizarse como una herramienta CLI independiente o integrarse en otros proyectos como una librería para proporcionar herramientas compuestas personalizadas.