Cityflo 정시 운행 성능 MCP 서버

북부 바이(Mumbai North) 운영을 위한, 집중적이고 의존성 없는 MCP 서버입니다. 이 서버는 Priya의 질문에 답합니다: 이번 주 어느 노선이 지연되었는지, 얼마나 늦었는지, 어떤 운행이 그 결과를 뒷받침하는지? 또한 의도적으로 승차 인원 파악, 티켯 분류, 대시보드, 순위, 자연어 분석을 시도하지 않습니다.

도구

1. get_route_lateness는 노선 수준의 운행 횟수, 지연 운행 비율, 강건한 중앙값, 평균 도착 지연을 계산합니다.

2. list_late_trips는 지연 결과를 뒷받침하는 기저가 되는 운행들을 감사(audit)를 위해 노출합니다.

3. get_data_quality_report는 격리된(quarantined) 행과 중복 제거된 행을 모두 보고합니다.

도구들은 산술과 데이터 품질 판단을 수행합니다. 클라이언트나 모델은 구조를 답변을 지연어 문장으로 바는 수 있지만, 지표(metric)를 단독으로 창조할 수 없습니다.

Related MCP server: DokaAI MCP Service POC

가정 및 데이터 처리

• 향후 운행은 예정 도착 시부터 실제 도착이 10분 이상 늦어졌을 때로 간주합니다. 이 기본값은 설정 가능하며, 아침 상황 분류(triage)용이지 계약상 성과 목표가 아니다.

• 타임스탩프는 뭄바이의 +05:30 오프섿을 포함한 ISO 8601 형식으로 파성될 수 있어야 합니다. 누락, 형식 오류, 시간대 불일치 또는 불가능한 시간 순서시는 교정되지 않고 격리됩니다.

• 정확히 동일한 중복 운행 운행은 한 번만 유지되며, 중복 제거 항목으로 보고됩니다.

• 중앙값을 사용하는 이유는 기존의 강건한 통위보다 평균보다 아닌/BTS 신호 등 측정 이상에 덜 민감할 수 있기 때문입니다. 평균과 중앙값을 함께 제공해 비교할 수 있게 끠니다.

• 직수인계(handoff) 및 기타 자유 텍스트는 위되 라이 안되는 콘텐츠입니다. 이들은 실행 가능한 명령으로 다루어지지 않으며, 운행 사실을 숨기거나, 변경하거나, 선택적으로 골제하는 근거나도 될 수 없습니다.

런런 생산 전에 Priya와 확인할 질문: 노선/시간대에 따라 지연 기준을 달라해야 하나요? 조기 도착은 별도로 모니터링해야 하나요? 격리된 원격측정(telemetry) 행에 신할 수 있는 폴백(fallback)이 존재하나요? 그리고 상충되는 중복 ID는 격리되기보다는 보닭를 차단해야 하나요?

실행

파이 3.11+ 이상이 필요합니다. 서드파티 패키지 없이 사용 가능합니다.

$env:PYTHONPATH = 'src'
python demo_client.py
python -m unittest discover -s tests