Transport NSW API Client MCP
NSW 교통 API 클라이언트(MCP 구현)
Transport NSW API와 직접 HTTP 요청을 사용하여 상호 작용하는 Claude MCP입니다.
에 대한
이 프로젝트는 Transport NSW의 API에 대한 MCP(Model Context Protocol) 서비스를 구현합니다.
Related MCP server: transport12 MCP Server
설정
이 저장소를 복제하세요
uv(빠른 Python 패키지 관리자)를 사용하여 종속성을 설치합니다.
지엑스피1
API 키로
.env파일을 만듭니다.OPEN_TRANSPORT_API_KEY=your_api_key_here(선택 사항) MCP 검사기를 실행합니다.
uv run mcp dev api.py그리고 http://localhost:5173 에서 서버를 방문하세요(포트는 다를 수 있음).
특징
정류장 찾기 API : 이름이나 좌표로 교통 정류장 찾기
알림 API : 교통 알림 및 중단에 대한 정보를 받으세요
출발 모니터 API : 교통 정류장의 실시간 출발 정보를 얻으세요
MCP 구현 : 모델 컨텍스트 프로토콜 서비스로 구성됨
사용 예
MCP 예제는 곧 제공됩니다. 아래는 표준 Python 예제입니다.
교통 정류장 찾기
from api import find_transport_stops
# Search by name
stops = find_transport_stops(stop_name="Central Station")
# Search by coordinates (Central Station area)
central_station = '151.206290:-33.884080:EPSG:4326'
stops = find_transport_stops(coord=central_station, radius=500)교통 알림 받기
from api import get_transport_alerts
# Get all current alerts
alerts = get_transport_alerts()
# Get alerts for a specific date
date_alerts = get_transport_alerts(date='22-03-2025')
# Get train alerts only (mot_type=1)
train_alerts = get_transport_alerts(mot_type=1)실시간 출발 모니터링
from api import get_departure_monitor
# Get departures from Central Station
departures = get_departure_monitor("200060") # Central Station ID
# Get departures for a specific time
from datetime import datetime
time_departures = get_departure_monitor("200060", time="15:30")
# Get only train departures
train_departures = get_departure_monitor("200060", mot_type=1) # 1 = Train데모 스크립트
이 프로젝트에는 모든 API 기능을 보여주는 포괄적인 데모 스크립트가 포함되어 있습니다.
# Run the full demo
python demo.py
# Run specific sections
python demo.py --stops # Stop finder demo
python demo.py --alerts # Transport alerts demo
python demo.py --departures # Departure monitoring demo테스트
로컬 테스트
pytest로 전체 테스트 모음을 실행합니다.
uv run pytest적용 범위 보고를 사용하여 실행:
uv run pytest --cov=api지속적인 통합
메인 브랜치에 대한 모든 푸시 및 풀 요청에 대해 GitHub Actions에서 테스트가 자동으로 실행됩니다. 워크플로는 다음과 같습니다.
Python 3.10을 설정합니다
uv 및 프로젝트 종속성을 설치합니다.
커버리지 보고를 통해 테스트를 실행합니다.
이 기능을 사용하려면:
OPEN_TRANSPORT_API_KEY를 GitHub 저장소 비밀로 추가하세요.코드를 GitHub에 푸시하세요
MCP 통합
이 프로젝트는 모델 컨텍스트 프로토콜 사양을 따르므로 AI 모델이 표준화된 인터페이스를 통해 NSW 교통 데이터에 액세스할 수 있습니다.
패키지 관리
이 프로젝트는 Rust로 작성된 최신 Python 패키지 관리자인 uv를 사용합니다. 종속성은 다음을 통해 관리됩니다.
pyproject.toml: 프로젝트 종속성을 정의합니다.uv.lock: 재현 가능한 환경에 대한 종속성 버전을 잠급니다.
Available Tools
3 toolsfind_transport_stopsB
Find transport stops around a specific location.
Args:
location_coord (str): Coordinates in format 'LONGITUDE:LATITUDE:EPSG:4326'
stop_type (str): Type of stops to find: 'BUS_POINT', 'POI_POINT', or 'GIS_POINT'
radius (int): Search radius in meters
Returns:
API response with transport stops
Inputs: location_coord (required), stop_type, radius.
get_departure_monitorA
Get real-time departure monitor information for a specific stop from the Trip Planner API.
This function uses direct HTTP requests to the Transport NSW API.
Args:
stop_id (str): Stop ID or global stop ID
date (str, optional): Date in DD-MM-YYYY format. Defaults to today's date.
time (str, optional): Time in HH:MM format. Defaults to current time.
mot_type (int, optional): Mode of transport type filter. Options:
1: Train
2: Metro
4: Light Rail
5: Bus
7: Coach
9: Ferry
11: School Bus
max_results (int, optional): Maximum number of results to return. Default is 1.
Returns:
list: Simplified list of departure information
Inputs: stop_id (required), date, time, mot_type, +1 more.
get_transport_alertsB
Get transport alerts from the Transport NSW API.
Args:
date (str, optional): Date in DD-MM-YYYY format. Defaults to today's date.
mot_type (int, optional): Mode of transport type filter. Options:
1: Train
2: Metro
4: Light Rail
5: Bus
7: Coach
9: Ferry
11: School Bus
stop_id (str, optional): Stop ID or global stop ID to filter by.
line_number (str, optional): Line number to filter by (e.g., '020T1').
operator_id (str, optional): Operator ID to filter by.
Returns:
dict: API response containing alerts information
Inputs: date, mot_type, stop_id, line_number, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: find_transport_stops locates stops, get_departure_monitor provides real-time departures, and get_transport_alerts retrieves service alerts. There is no overlap in functionality, and the descriptions clearly differentiate their roles.
All tool names follow a consistent verb_noun pattern using snake_case: find_transport_stops, get_departure_monitor, and get_transport_alerts. The naming is predictable and readable throughout the set.
With only 3 tools, the set feels thin for a transport API client, lacking operations like route planning, trip details, or fare information. While the tools cover basic needs, the scope suggests more comprehensive coverage would be expected.
The tools provide core functionality for stops, departures, and alerts, but there are notable gaps. Missing operations include trip planning, route searches, service status beyond alerts, and fare queries, which are typical for a transport API and could limit agent effectiveness.
Maintenance
Related MCP Connectors
Transport for NSW MCP — journey planning, live departures, service alerts and commuter car-park…
Transport for London (TfL) Unified API MCP — keyless.
Swiss Transport MCP — wraps Transport Open Data API (free, no auth)
Provide real-time transportation data including bus arrivals, train service alerts, carpark availa…
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server for interacting with the Berlin Public Transport (BVG) API to search for locations and plan journeys. It provides real-time access to departures, arrivals, trip details, and vehicle tracking within Berlin's transit network.MIT
- AlicenseBqualityDmaintenanceMCP server that integrates with the transport12 API to provide tools for searching stops, routes, arrivals, and vehicle forecasts, enabling natural language interaction with public transport data.1711 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables querying real-time BART and SF Muni transit data, including departures, trip planning, fares, advisories, routes, alerts, vehicle positions, and schedules, from any MCP-compatible client.1MIT
- AlicenseAqualityBmaintenanceEnables LLM clients to search stops, plan journeys, check live departures, service alerts, nearby locations, and vehicle positions using Transport for NSW open data, with per-request API key authentication.101MIT