madurai-transit-mcp
🚌 マドゥライ・シティバス Model Context Protocol (MCP) サーバー
マドゥライ・シティバス公共交通機関向けの公式 Model Context Protocol (MCP) サーバーです。AIアシスタント(Claude Desktop、Cursor、Gemini、AIエージェント)をマドゥライのバス路線網、公式区間運賃、停留所順序、プラットフォーム・ベイ発着情報に接続します。
⚡ 特徴
路線検索: マドゥライの966のバス路線と3,000の停留所を対象に、直通および乗り換え1回のルート検索が可能。
公式区間運賃: 権威あるTNSTC区間運賃の内訳(Ordinary、LSS、Express、Deluxe AC)。
プラットフォーム・ベイ情報: ペリヤール・バススタンドの発車プラットフォーム(I/II/III/IV)。
バイリンガル停留所検索: 英語、タミル語Unicode(
பெரியார்)、または口語的な音訳での停留所検索が可能。インタラクティブなディープリンク: ライブのビジュアル路線マップへの正規リンク(
https://maduraione.in/route/...)を自動的に返します。
Related MCP server: Singapore Bus MCP Server
🚀 クイックセットアップ
1. Claude Desktop
claude_desktop_config.json に以下の設定を追加します:
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
.cursor/mcp.json または Cursor設定 ➔ 機能 ➔ MCP に以下を追加します:
{
"mcpServers": {
"madurai-bus": {
"command": "npx",
"args": ["-y", "madurai-transit-mcp"]
}
}
}3. MCP Inspectorによるローカルテスト
公式のMCP Inspectorを使用して、すべてのツールを対話的にテストできます:
npx @modelcontextprotocol/inspector npx -y madurai-transit-mcp🛠️ 利用可能なMCPツール
search_bus_routes
マドゥライ内の2地点間の直通および乗り換え1回のバス路線を検索します。
{
"from": "Periyar",
"to": "Alagarkovil",
"max_transfers": 1
}get_bus_details
特定のバス番号について、完全な路線詳細、スポーク区分、発車プラットフォーム・ベイ、および完全な停留所順序を取得します。
{
"bus_number": "44"
}search_bus_stops
バス停のバイリンガル検索(英語&タミル語)。スポーク分類と検証済みGPS座標付き。
{
"query": "பெரியார்"
}calculate_fare
全サービス区分(Ordinary、LSS、Express、Deluxe AC)にわたる正確な公式TNSTC区間運賃を計算します。
{
"boarding_stop": "PERIYAR BUS STAND",
"alighting_stop": "MGR BUS STAND",
"bus_number": "77"
}⚠️ 現場の実情と免責事項
インドの地方中核都市(Tier-2)の公共交通機関は、欧米の交通モデルとは異なる運用がされています:
運行間隔頻度と時刻表: TNSTCマドゥライのバスは、分単位のデジタル時刻表ではなく、シフト制の運行間隔頻度で運行されています。
トポロジカルGPSと実測GPS: 県内の約3,000の停留所のうち、約600の都心部の主要停留所のみ検証済みの測量座標を持っています。残りの郊外・準都市部の停留所は、順序に基づいてトポロジカルにマッピングされています。
複数区間の乗り換え: 乗り換え提案は7スポーク・マドゥライ・トポロジカルモデルを使用しており、参考情報として扱う必要があります。通勤者はバスターミナルでライブのプラットフォーム発車情報を確認してください。
🌐 提供元
Webアプリ&ライブバステレメトリ: https://maduraione.in
Androidアプリ(Google Play): Google PlayのMadurai CityBus
GitHubリポジトリ: https://github.com/rsiva2294/madurai-transit-mcp
📄 ライセンス
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