🚌 Madurai CityBus Model Context Protocol (MCP) Server

Официальный сервер Model Context Protocol (MCP) для общественного транспорта Madurai CityBus, подключающий ИИ-ассистентов (Claude Desktop, Cursor, Gemini, AI Agents) к сети автобусных маршрутов Мадурая, официальным тарифам по этапам, последовательности остановок и отправлениям с платформ.

⚡ Возможности

• Поиск маршрутов: Прямые маршруты и маршруты с одной пересадкой по 966 автобусным маршрутам и 3000 остановок в Мадурае.

• Официальные тарифы по этапам: Авторитетные разбивки тарифов TNSTC по этапам (Ordinary, LSS, Express, Deluxe AC).

• Информация о платформах отправления: Платформы отправления (I/II/III/IV) на автобусной станции Periyar.

• Двуязычный поиск остановок: Поиск остановок на английском, тамильском 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 Settings ➔ Features ➔ 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

Рассчитайте точные официальные тарифы TNSTC по этапам для всех классов обслуживания (Ordinary, LSS, Express, Deluxe AC).

{
  "boarding_stop": "PERIYAR BUS STAND",
  "alighting_stop": "MGR BUS STAND",
  "bus_number": "77"
}

⚠️ Реальные условия и оговорки

Общественный транспорт в индийских городах второго уровня работает иначе, чем западные модели транзита:

1. Частота движения по интервалам против расписаний: Автобусы TNSTC Madurai работают по сменной частоте движения, а не по опубликованным поминутным цифровым расписаниям.

2. Топологические против геодезических GPS: Из ~3000 остановок по округу ~600 основных городских остановок имеют проверенные геодезические координаты. Остальные сельские/пригородные остановки нанесены на карту топологически по последовательности.

3. Пересадки с несколькими участками: Рекомендации по пересадкам используют 7-спицевую топологическую модель Мадурая и должны рассматриваться как ориентир. Пассажирам следует проверять актуальные отправления с платформ на автобусных станциях.

🌐 На базе

• Веб-приложение и телеметрия автобусов в реальном времени: https://maduraione.in

• Android-приложение (Google Play): Madurai CityBus on Google Play

• Репозиторий GitHub: https://github.com/rsiva2294/madurai-transit-mcp

📄 Лицензия

MIT © MaduraiOne