🚌 Madurai CityBus Model Context Protocol (MCP) Servidor

El servidor oficial Model Context Protocol (MCP) para el transporte público Madurai CityBus, que conecta asistentes de IA (Claude Desktop, Cursor, Gemini, AI Agents) con la red de rutas de autobús de Madurai, tarifas oficiales por etapas, secuencias de paradas y salidas de andenes.

⚡ Características

• Descubrimiento de rutas: Enrutamiento directo y con 1 transbordo a través de 966 rutas de autobús y 3,000 paradas en Madurai.

• Tarifas oficiales por etapas: Desgloses autorizados de tarifas por etapas de TNSTC (Ordinario, LSS, Expreso, Deluxe AC).

• Inteligencia de andenes: Plataformas de salida (I/II/III/IV) en la estación de autobuses Periyar.

• Búsqueda bilingüe de paradas: Busque paradas en inglés, tamil Unicode (பெரியார்) o transliteraciones coloquiales.

• Enlaces profundos interactivos: Devuelve automáticamente enlaces canónicos (https://maduraione.in/route/...) para mapas visuales de rutas en vivo.

Related MCP server: Winnipeg City MCP Server

🚀 Configuración rápida

1. Claude Desktop

Añade esta configuración a tu claude_desktop_config.json:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "madurai-bus": {
      "command": "npx",
      "args": ["-y", "madurai-transit-mcp"]
    }
  }
}

2. Cursor IDE

Añade esto a .cursor/mcp.json o en Cursor Settings ➔ Features ➔ MCP:

{
  "mcpServers": {
    "madurai-bus": {
      "command": "npx",
      "args": ["-y", "madurai-transit-mcp"]
    }
  }
}

3. Pruebas locales con MCP Inspector

Puedes probar todas las herramientas de forma interactiva usando el MCP Inspector oficial:

npx @modelcontextprotocol/inspector npx -y madurai-transit-mcp

🛠️ Herramientas MCP disponibles

search_bus_routes

Encuentra rutas de autobús directas y con 1 transbordo entre dos ubicaciones en Madurai.

{
  "from": "Periyar",
  "to": "Alagarkovil",
  "max_transfers": 1
}

get_bus_details

Obtén detalles completos de la ruta, categoría de radio, andén de salida y la secuencia completa de paradas para un número de autobús específico.

{
  "bus_number": "44"
}

search_bus_stops

Búsqueda bilingüe (inglés y tamil) de paradas de autobús con clasificaciones de radio y coordenadas GPS verificadas.

{
  "query": "பெரியார்"
}

calculate_fare

Calcula las tarifas oficiales exactas por etapas de TNSTC en todas las clases de servicio (Ordinario, LSS, Expreso, Deluxe AC).

{
  "boarding_stop": "PERIYAR BUS STAND",
  "alighting_stop": "MGR BUS STAND",
  "bus_number": "77"
}

⚠️ Realidades sobre el terreno y avisos

El transporte público en ciudades indias de segundo nivel opera de manera diferente a los modelos de transporte occidentales:

1. Frecuencia de paso vs. horarios: Los autobuses de TNSTC Madurai operan con frecuencia de paso basada en turnos en lugar de horarios digitales publicados minuto a minuto.

2. GPS topológico vs. medido: De las ~3,000 paradas del distrito, ~600 paradas urbanas principales tienen coordenadas de levantamiento verificadas. Las paradas rurales y periurbanas restantes se mapean topológicamente por secuencia.

3. Transbordos de múltiples tramos: Las sugerencias de intercambio utilizan el Modelo topológico de 7 radios de Madurai y deben tratarse como orientación. Los viajeros deben verificar las salidas de andenes en vivo en las estaciones de autobuses.

🌐 Desarrollado por

• Aplicación web y telemetría de autobuses en vivo: https://maduraione.in

• Aplicación Android (Google Play): Madurai CityBus en Google Play

• Repositorio de GitHub: https://github.com/rsiva2294/madurai-transit-mcp

📄 Licencia

MIT © MaduraiOne