# subway-mcp-server

[![CI](https://github.com/MauricioPerera/subway-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/MauricioPerera/subway-mcp-server/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
[![Node.js >= 18](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
[![MCP](https://img.shields.io/badge/MCP-server-blue.svg)](https://modelcontextprotocol.io)
[![Coverage](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/MauricioPerera/subway-mcp-server/master/badges/coverage.json)](https://github.com/MauricioPerera/subway-mcp-server/actions/workflows/ci.yml)

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:

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

y devuelve:

```json
{
  "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:

```json
{
  "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.