🚌 マドゥライ・シティバス 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: Winnipeg City MCP Server

🚀 クイックセットアップ

1. Claude Desktop

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

.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）の公共交通機関は、欧米の交通モデルとは異なる運用がされています:

1. 運行間隔頻度と時刻表: TNSTCマドゥライのバスは、分単位のデジタル時刻表ではなく、シフト制の運行間隔頻度で運行されています。

2. トポロジカルGPSと実測GPS: 県内の約3,000の停留所のうち、約600の都心部の主要停留所のみ検証済みの測量座標を持っています。残りの郊外・準都市部の停留所は、順序に基づいてトポロジカルにマッピングされています。

3. 複数区間の乗り換え: 乗り換え提案は7スポーク・マドゥライ・トポロジカルモデルを使用しており、参考情報として扱う必要があります。通勤者はバスターミナルでライブのプラットフォーム発車情報を確認してください。

🌐 提供元

• Webアプリ＆ライブバステレメトリ: https://maduraione.in

• Androidアプリ（Google Play）: Google PlayのMadurai CityBus

• GitHubリポジトリ: https://github.com/rsiva2294/madurai-transit-mcp

📄 ライセンス

MIT © MaduraiOne