# Transporter CC MCP Server

Servidor MCP (Model Context Protocol) para búsqueda de rutas de TransMilenio y SITP en Bogotá, con tracking GPS en vivo.

## Herramientas disponibles

| Herramienta | Descripción |
|---|---|
| `find_route` | Busca rutas entre origen y destino (directas o con transbordo) |
| `nearby_stops` | Encuentra paraderos cercanos a una ubicación |
| `get_bus_locations` | Posiciones GPS de buses en una ruta, con distancia a un punto de referencia |
| `get_arrivals` | Tiempos estimados de llegada de buses a un paradero |
| `get_stops` | Lista completa de paraderos |
| `get_routes_at_stop` | Rutas que paran en una estación/paradero |
| `get_route_info` | Recorrido y paraderos de una ruta |

## Instalación

```bash
git clone https://github.com/carloscrcalderon/transporter_cc_mcp.git
cd transporter_cc_mcp
uv sync
```

## Configuración

Copiá `.env.example` a `.env` y configurá:

```env
GOOGLE_MAPS_API_KEY=tu_api_key_aqui
```

Las demás variables usan defaults funcionales (credenciales públicas de la API SITP y realtime provider).

## Ejecución local

### SSE (recomendado para agentes)

```bash
uv run transporter_cc_mcp --transport sse --host 0.0.0.0 --port 8080
```

El endpoint SSE queda en `http://localhost:8080/sse`.

### Stdio

```bash
uv run transporter_cc_mcp --transport stdio
```

## Conectar con agentes

Para ver la **guía detallada con diagrama de flujo, ejemplos conversacionales, reglas de negocio y máquina de estados**, consulta la [Guía de Integración para Agentes (docs/agent_integration.md)](file:///home/nakc/trans_mcp/docs/agent_integration.md).

### Hermes Agent

Agregá al `mcp.json` de Hermes:

```json
{
  "mcpServers": {
    "transporter_cc": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}
```

### OpenClaw

Agregá al config de OpenClaw (`~/.openclaw/config.yaml` o donde lo tengas):

```yaml
mcp_servers:
  transporter_cc:
    type: sse
    url: http://localhost:8080/sse
```

## Pruebas

```bash
uv run pytest
```