🚌 Madurai CityBus Model Context Protocol (MCP) Server

Der offizielle Model Context Protocol (MCP)-Server für den öffentlichen Nahverkehr von Madurai CityBus, der KI-Assistenten (Claude Desktop, Cursor, Gemini, AI Agents) mit dem Busroutennetz von Madurai, den offiziellen Fahrpreisen, Haltestellenabfolgen und Abfahrtsplattformen verbindet.

⚡ Funktionen

• Routenfindung: Direkte und 1-Umstieg-Routen über 966 Busrouten und 3.000 Haltestellen in Madurai.

• Offizielle Fahrpreise: Maßgebliche TNSTC-Fahrpreisaufschlüsselungen (Ordinary, LSS, Express, Deluxe AC).

• Plattform-Intelligenz: Abfahrtsplattformen (I/II/III/IV) am Periyar-Busbahnhof.

• Zweisprachige Haltestellensuche: Suchen Sie Haltestellen auf Englisch, Tamil-Unicode (பெரியார்) oder umgangssprachlichen Transliterationen.

• Interaktive Deep Links: Gibt automatisch kanonische Links (https://maduraione.in/route/...) für live visuelle Routenkarten zurück.

Related MCP server: Winnipeg City MCP Server

🚀 Schnellstart

1. Claude Desktop

Fügen Sie diese Konfiguration zu Ihrer claude_desktop_config.json hinzu:

• 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

Fügen Sie dies zu .cursor/mcp.json oder in Cursor Settings ➔ Features ➔ MCP hinzu:

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

3. Lokales Testen mit MCP Inspector

Sie können alle Tools interaktiv mit dem offiziellen MCP Inspector testen:

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

🛠️ Verfügbare MCP-Tools

search_bus_routes

Finden Sie direkte und 1-Umstieg-Busverbindungen zwischen zwei Orten in Madurai.

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

get_bus_details

Erhalten Sie vollständige Routendetails, Speichenkategorie, Abfahrtsplattform und die komplette Haltestellenabfolge für eine bestimmte Busnummer.

{
  "bus_number": "44"
}

search_bus_stops

Zweisprachige Suche (Englisch & Tamil) nach Bushaltestellen mit Speichenklassifizierungen und verifizierten GPS-Koordinaten.

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

calculate_fare

Berechnen Sie exakte offizielle TNSTC-Fahrpreise für alle Serviceklassen (Ordinary, LSS, Express, Deluxe AC).

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

⚠️ Realitäten vor Ort & Haftungsausschlüsse

Der öffentliche Nahverkehr in indischen Städten der zweiten Reihe funktioniert anders als westliche Nahverkehrsmodelle:

1. Taktfrequenz vs. Fahrpläne: TNSTC-Busse in Madurai fahren nach schichtbasierten Taktfrequenzen und nicht nach veröffentlichten minütlichen digitalen Fahrplänen.

2. Topologisch vs. vermessenes GPS: Von den ~3.000 Haltestellen im Bezirk haben ~600 zentrale städtische Haltestellen verifizierte Vermessungskoordinaten. Die übrigen ländlichen/stadtnaben Haltestellen werden topologisch nach Reihenfolge kartiert.

3. Mehrbeinige Umstiege: Umstiegsvorschläge verwenden das 7-Speichen-Madurai-Topologiemodell und sollten als Orientierungshilfe betrachtet werden. Pendler sollten die Live-Abfahrtsplattformen an den Busbahnhöfen überprüfen.

🌐 Unterstützt von

• Web-App & Live-Bus-Telemetrie: https://maduraione.in

• Android-App (Google Play): Madurai CityBus bei Google Play

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

📄 Lizenz

MIT © MaduraiOne