🚌 Madurai CityBus 模型上下文协议（MCP）服务器

Madurai CityBus 公共交通的官方**模型上下文协议（MCP）**服务器，将 AI 助手（Claude Desktop、Cursor、Gemini、AI Agents）连接到马杜赖的公交线路网络、官方分段票价、站点顺序和站台发车信息。

⚡ 功能特性

• 线路发现：在马杜赖的 966 条公交线路和 3,000 个站点之间进行直达和一次换乘路线规划。

• 官方分段票价：权威的 TNSTC 分段票价明细（Ordinary、LSS、Express、Deluxe AC）。

• 站台智能：Periyar 汽车站的发车平台（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

查找马杜赖两个地点之间的直达和一次换乘公交路线。

{
  "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"
}

⚠️ 现实情况与免责声明

印度二线城市的公共交通运营方式与西方交通模式不同：

1. 发车间隔频率 vs. 时刻表：TNSTC 马杜赖公交按班次间隔频率运营，而非发布分钟级的数字时刻表。

2. 拓扑定位 vs. 实测 GPS：全区约 3,000 个站点中，约 600 个核心城区站点拥有经过验证的测量坐标。其余农村/城郊站点按序列进行拓扑映射。

3. 多段换乘：换乘建议基于 7-Spoke Madurai Topological Model，仅供参考。乘客应在汽车站核实实时站台发车信息。

🌐 技术支持

• Web 应用与实时公交遥测：https://maduraione.in

• Android 应用（Google Play）：Madurai CityBus 在 Google Play

• GitHub 仓库：https://github.com/rsiva2294/madurai-transit-mcp

📄 许可证

MIT © MaduraiOne