madurai-transit-mcp
🚌 Madurai CityBus MCP(모델 컨텍스트 프로토콜) 서버
마두라이 시내버스 대중교통을 위한 공식 MCP(모델 컨텍스트 프로토콜) 서버로, AI 어시스턴트(Claude Desktop, Cursor, Gemini, AI 에이전트)를 마두라이의 버스 노선망, 공식 구간 요금, 정류장 순서, 플랫폼 베이 출발 정보에 연결합니다.
⚡ 주요 기능
노선 검색: 마두라이의 966개 버스 노선과 3,000개 정류장을 대상으로 직행 및 1회 환승 경로를 제공합니다.
공식 구간 요금: TNSTC 공식 구간별 요금표(일반, LSS, 급행, 델럭스 AC)를 제공합니다.
플랫폼 베이 정보: 페리야르 버스 터미널의 출발 플랫폼(I/II/III/IV)을 안내합니다.
이중 언어 정류장 검색: 영어, 타밀어 유니코드(
பெரியார்), 또는 구어체 음역으로 정류장을 검색할 수 있습니다.인터랙티브 딥 링크: 실시간 시각적 노선도를 위한 표준 링크(
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
마두라이 내 두 지점 사이의 직행 및 1회 환승 버스 노선을 찾습니다.
{
"from": "Periyar",
"to": "Alagarkovil",
"max_transfers": 1
}get_bus_details
특정 버스 번호에 대한 전체 노선 정보, 스포크(spoke) 카테고리, 출발 플랫폼 베이, 전체 정류장 순서를 제공합니다.
{
"bus_number": "44"
}search_bus_stops
버스 정류장에 대한 이중 언어 검색(영어 및 타밀어)으로, 스포크 분류와 검증된 GPS 좌표를 제공합니다.
{
"query": "பெரியார்"
}calculate_fare
모든 서비스 등급(일반, LSS, 급행, 델럭스 AC)에 대한 정확한 공식 TNSTC 구간 요금을 계산합니다.
{
"boarding_stop": "PERIYAR BUS STAND",
"alighting_stop": "MGR BUS STAND",
"bus_number": "77"
}⚠️ 현실적 한계 및 고지사항
티어 2 인도 도시의 대중교통은 서양의 교통 모델과 다르게 운영됩니다:
배차 간격 vs. 시간표: TNSTC 마두라이 버스는 분 단위 디지털 시간표가 아닌 교대제 기반 배차 간격으로 운영됩니다.
위상 기반 vs. 실측 GPS: 지역 내 약 3,000개 정류장 중 약 600개의 핵심 도심 정류장만 검증된 실측 좌표를 보유하고 있습니다. 나머지 농촌/교외 정류장은 순서에 따라 위상 기반으로 매핑됩니다.
다중 구간 환승: 환승 제안은 7-스포크 마두라이 위상 모델을 기반으로 하며 참고용으로만 간주해야 합니다. 통근자는 버스 터미널에서 실시간 플랫폼 출발 정보를 확인해야 합니다.
🌐 제공 주체
웹 앱 및 실시간 버스 원격 측정: 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