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

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á:

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)

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

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

Stdio

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:

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

OpenClaw

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

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

Pruebas

uv run pytest