Skip to main content
Glama

🚌 Madurai CityBus Model Context Protocol (MCP) Server

npm version rsiva2294/madurai-transit-mcp MCP server License: MIT Powered by MaduraiOne

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


📄 Lizenz

MIT © MaduraiOne

Available Tools

4 tools
calculate_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

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides real-time Transport for London journey data, including routes, alerts, and disruptions, allowing AI assistants to search journeys and get station information.
      1
      8 npm
      4
      ISC
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      10
      1
      MIT