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

Related MCP server: Malaysia Transit MCP

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).

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