Skip to main content
Glama

🚌 Madurai CityBus MCP(모델 컨텍스트 프로토콜) 서버

npm version rsiva2294/madurai-transit-mcp MCP server License: MIT Powered by MaduraiOne

마두라이 시내버스 대중교통을 위한 공식 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.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-스포크 마두라이 위상 모델을 기반으로 하며 참고용으로만 간주해야 합니다. 통근자는 버스 터미널에서 실시간 플랫폼 출발 정보를 확인해야 합니다.


🌐 제공 주체


📄 라이선스

MIT © MaduraiOne

Available Tools

4 tools
calculate_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

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides real-time Transport for London journey data, including routes, alerts, and disruptions, allowing AI assistants to search journeys and get station information.
      1
      8 npm
      4
      ISC
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      10
      1
      MIT