subway-mcp-server

MCP server local que expone codex, claude (Claude Code) y agy (Antigravity) como tools de delegación, para que un agente orquestador les reparta tareas vía CLI en modo no interactivo.

Tools

• delegate_to_codex — codex exec
• delegate_to_claude — claude -p --output-format json
• delegate_to_agy — agy -p

Todas comparten el mismo input:

Campo	Tipo	Default	Descripción
prompt	string	—	instrucciones para el sub-agente
cwd	string	cwd del server	directorio de trabajo absoluto
model	string	el default de cada CLI	override de modelo
timeout_seconds	number	600 (máx 1800)	mata el proceso si excede
auto_approve	boolean	false	evita prompts de permisos de la CLI (necesario para casi cualquier tarea real, porque no hay terminal para aprobar)

Output: { success, final_message, exit_code, timed_out, stderr? } (stderr solo si success=false).

Build

npm install
npm run build

Tests

npm test

Cubre cliRunner (spawn, captura de stdout/stderr, cwd, timeout, comando inexistente) y la construcción de argumentos/parseo de salida de cada tool (argBuilders), sin invocar los CLIs reales de pago.

Cobertura local: npm run coverage. En CI, el job coverage la calcula en cada push a master y commitea badges/coverage.json (leído por el badge del README vía shields.io endpoint) — delegate.ts e index.ts quedan en 0% porque solo se ejercitan invocando los CLIs reales, fuera del alcance de estos tests.

Registrar en Claude Code

claude mcp add subway -- node D:/Repo/subway/dist/index.js

Ejemplo de uso

Una vez registrado, desde cualquier sesión de Claude Code en el proyecto podés pedirle al agente que delegue directamente, por ejemplo:

Delegá a agy: "Reply with exactly: PONG", con auto_approve true

Eso dispara una llamada al tool mcp__subway__delegate_to_agy con:

{
  "prompt": "Reply with exactly: PONG",
  "auto_approve": true
}

y devuelve:

{
  "success": true,
  "final_message": "PONG",
  "exit_code": 0,
  "timed_out": false
}

Mismo patrón para delegate_to_codex y delegate_to_claude, cambiando solo el nombre del tool. Para correr en otro directorio o con otro modelo:

{
  "prompt": "Corré los tests y reportá cuáles fallan",
  "cwd": "D:/Repo/otro-proyecto",
  "model": "claude-opus-4-8",
  "auto_approve": true,
  "timeout_seconds": 900
}

Notas

• Requiere que codex, claude y agy estén en el PATH y ya autenticados en la máquina.
• No hay gate de verificación (CCDD) ni orquestación de multi-tarea acá — es solo el mecanismo de delegación. Componer lógica de PM/orquestación por encima queda del lado del agente que use este MCP.