agent-bridge-mcp

Un servidor MCP y puerta de enlace HTTP que distribuye tareas de codificación a sesiones CLI de Claude Code, Codex y Antigravity (agy), realiza un seguimiento de esas sesiones y, opcionalmente, ejecuta un bucle de implementar → revisar → verificar contra un repositorio real.

Estado: experimental. Esto comenzó como un rig de orquestación personal y se publica con la esperanza de que las partes de enrutamiento de sesiones y puerta de evidencia sean útiles para otros. Las interfaces cambiarán.

Qué hace

• Enrutamiento de sesiones — inicia y reanuda sesiones de Claude Code / Codex por proyecto y tema, para que los mensajes de seguimiento aterricen en el mismo contexto.

• Seguimiento de tareas — cada envío se convierte en una tarea con estado, salida y código de salida.

• Puerta de evidencia — ejecuta los comandos de prueba que especifiques en un repositorio e informa si el cambio está realmente respaldado por pruebas que pasan antes de que lo aceptes.

• Bucle de revisión — envía un agente implementador y un agente revisor por turnos, hasta un límite de revisiones, controlado por la comprobación de evidencia.

• Puerta de enlace — las mismas capacidades a través de HTTP + WebSocket, para que un cliente remoto (por ejemplo, un teléfono) pueda enviar trabajo y transmitir la salida.

Instalar

npm install -g @yukinuma/agent-bridge-mcp

Requiere Node.js 20+, además de cualquiera de las CLI de agente que pretendas usar (claude, codex y/o agy) ya instaladas y autenticadas.

Una nota sobre el agente antigravity

agy ejecuta un servidor de lenguaje interno y espera un terminal real. Iniciado desde una tubería normal, se apaga antes de responder, lo que desde el lado de la persona que llama es indistinguible de un bloqueo. En Windows, este adaptador lo ejecuta bajo winpty (incluido con Git para Windows) y mantiene stdin abierto durante la duración de la llamada.

Dos consecuencias que vale la pena conocer:

• winpty aborta con su propia aserción al cerrarse, por lo que su código de salida no refleja lo que hizo agy. Cuando se ejecuta a través de un pty, el adaptador juzga el éxito por si se recibió una respuesta, no por el código de salida, y filtra el texto de la aserción de la salida capturada.

• Al agotarse el tiempo de espera, el árbol de procesos se elimina por PID. Matar por nombre de imagen eliminaría cualquier agy interactivo que tengas abierto en otro lugar, por lo que deliberadamente no se hace.

Establece WINPTY_PATH o AGY_PATH si alguno de los binarios está en una ubicación no estándar. En plataformas que no son Windows, agy se lanza directamente, lo cual no está probado.

Usar como servidor MCP

{
  "mcpServers": {
    "agent-bridge": {
      "command": "agent-bridge-mcp",
      "env": {
        "AGENT_BRIDGE_WORKSPACE": "/path/to/your/projects"
      }
    }
  }
}

Herramientas expuestas: agent_send, agent_status, agent_sessions, agent_cancel.

Usar como puerta de enlace

export ABC_AUTH_TOKEN="$(openssl rand -hex 24)"
export AGENT_BRIDGE_WORKSPACE="/path/to/your/projects"
agent-bridge-gateway

La puerta de enlace se niega a iniciarse sin ABC_AUTH_TOKEN. No hay un token predeterminado.

Endpoints

/api/dispatch, /api/git/commit-push y /api/review-loop requieren un objetivo explícito: ya sea cwd, o un project que se resuelva dentro del espacio de trabajo. Devuelven 400 en lugar de recurrir a un directorio predeterminado, y los valores de project que escapen del espacio de trabajo son rechazados.

Seguridad

Este servicio ejecuta agentes de codificación con sus indicaciones de seguridad desactivadas. Eso es lo que hace que el envío desatendido funcione — un agente que se detiene para pedir aprobación simplemente se bloquea cuando nadie está en el teclado — pero significa que cualquiera que pueda alcanzar la API puede ejecutar código arbitrario como el usuario que ejecuta la puerta de enlace.

Específicamente, los adaptadores CLI pasan:

Ambos omiten por defecto. Las exclusiones son opciones a nivel de adaptador; aún no están conectadas a través de las herramientas MCP o la API REST, por lo que a través de HTTP la omisión es actualmente incondicional.

Trata esto como un demonio local privilegiado:

• Se vincula a 127.0.0.1 por defecto. Establecer AGENT_BRIDGE_HOST a cualquier otra cosa expone el envío de tareas, la ejecución de código sin zona de pruebas y el envío de git a tu red.

• El token de autenticación es un único secreto compartido, enviado como un encabezado bearer o un parámetro de consulta token. Los parámetros de consulta terminan en los registros — prefiere el encabezado donde puedas. Comprometer ese único token equivale a entregar un shell.

• No hay aislamiento entre proyectos más allá de la verificación de la ruta del espacio de trabajo.

• /api/git/commit-push envía a cualquier remoto que tenga configurado el repositorio de destino. No vuelve a preguntar antes de enviar.

No expongas esto a una red no confiable y no lo ejecutes como un usuario con más acceso del que el trabajo realmente necesita.

Desarrollo

npm install
npm run typecheck
npm run build

Licencia

MIT