内容
# 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
```
MCP 市场