madurai-transit-mcp
🚌 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: Singapore Bus 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.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.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:
Taktfrequenz vs. Fahrpläne: TNSTC-Busse in Madurai fahren nach schichtbasierten Taktfrequenzen und nicht nach veröffentlichten minütlichen digitalen Fahrplänen.
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.
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
Available Tools
4 toolscalculate_fareB
Calculate the official TNSTC stage fare between any boarding and alighting bus stop in Madurai across Ordinary, LSS, Express, and Deluxe/AC classes based on authoritative stage charts.
Inputs: boarding_stop (required), alighting_stop (required), bus_number.
get_bus_detailsA
Lookup route details, platform bay at Periyar Bus Stand, spoke category, and stop sequence for a specific Madurai bus number (e.g. '44', '77', '11A', '5'). By default returns key transit milestones for token efficiency; set verbose=true for the complete numbered stop list.
Inputs: bus_number (required), verbose.
search_bus_routesA
Search bus routes between two stops in Madurai. Returns direct buses and 1-transfer options with stop counts, PBS platform bays, official TNSTC stage fares, and canonical visual map links. By default returns key milestones for token efficiency; set verbose=true for complete stop sequences.
Inputs: to (required), from (required), verbose, max_transfers.
search_bus_stopsA
Bilingual (English and Tamil) autocomplete and search for bus stops across Madurai. Returns canonical name, Tamil script name, spoke corridor, route frequency, and verified GPS coordinates if available.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: finding routes between stops, retrieving details for a specific bus number, searching stops, and calculating fares. No overlapping functionality, so an agent can easily select the right tool.
All tool names follow a consistent verb_noun pattern in snake_case (search_bus_routes, get_bus_details, search_bus_stops, calculate_fare). This creates a predictable and uniform naming convention.
With only 4 tools, the server is well-scoped for its narrow domain of Madurai bus transit. Each tool serves a necessary function, and the count is within the ideal 3-15 range.
The tool surface covers the core transit workflows: route search, bus details, stop lookup, and fare calculation. Missing features like schedule or real-time tracking are not implied by the domain scope, so only minor gaps exist.
Maintenance
Related MCP Connectors
Mobility, geocoding and nearby urban services for AI agents.
Real-time transit stops, routes, arrivals, vehicle positions, and schedules via OneBusAway APIs.
Provide real-time transportation data including bus arrivals, train service alerts, carpark availa…
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides real-time Transport for London journey data, including routes, alerts, and disruptions, allowing AI assistants to search journeys and get station information.18 npm4ISC
- FlicenseNot gradedqualityDmaintenanceProvides real-time Singapore bus information, including arrival times, routes, and stop details via the LTA DataMall API.1-
- AlicenseNot gradedqualityBmaintenanceEnables local AI clients to search Houston METRO routes, stops, nearby stops, realtime arrivals, and service alerts through natural language.MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to query live arrivals, vehicle positions, routes, stops, and timetables across the Athens public transport network, with stop lookups by name or coordinate in Greek or Latin script. Results cover OASA buses, trolleys, metro, and tram, falling back to cached reference data when the upstream API is unreachable.101MIT