🚌 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: 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

마두라이 내 두 지점 사이의 직행 및 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 인도 도시의 대중교통은 서양의 교통 모델과 다르게 운영됩니다:

1. 배차 간격 vs. 시간표: TNSTC 마두라이 버스는 분 단위 디지털 시간표가 아닌 교대제 기반 배차 간격으로 운영됩니다.

2. 위상 기반 vs. 실측 GPS: 지역 내 약 3,000개 정류장 중 약 600개의 핵심 도심 정류장만 검증된 실측 좌표를 보유하고 있습니다. 나머지 농촌/교외 정류장은 순서에 따라 위상 기반으로 매핑됩니다.

3. 다중 구간 환승: 환승 제안은 7-스포크 마두라이 위상 모델을 기반으로 하며 참고용으로만 간주해야 합니다. 통근자는 버스 터미널에서 실시간 플랫폼 출발 정보를 확인해야 합니다.

🌐 제공 주체

• 웹 앱 및 실시간 버스 원격 측정: https://maduraione.in

• Android 앱(Google Play): Google Play의 Madurai CityBus

• GitHub 저장소: https://github.com/rsiva2294/madurai-transit-mcp

📄 라이선스

MIT © MaduraiOne