Cityflo 准点率 MCP 服务器

一个专注于孟买北部运营的、零依赖的 MCP 服务器。它回答 Priya 的问题：本周某条线路是否晚点、晚点了多少，以及哪些行程支持该结果？ 它有意不涉及载客量、工单分类、仪表盘、排名或自然语言解析。

工具

1. get_route_lateness 计算线路级别的行程数、晚点占比、稳健中位数和平均到达延误。

2. list_late_trips 公开底层晚点行程以供审计。

3. get_data_quality_report 报告每一行被隔离和去重的数据。

这些工具负责算术运算和数据质量决策。客户端或模型可以将结构化答案转换为自然语言，但不能凭空捏造指标。

Related MCP server: DokaAI MCP Service POC

假设与数据处理

• 当实际到达时间晚于计划到达时间超过 10 分钟时，该行程即视为晚点。此可配置的默认值用于早间分诊，而非合同约定的绩效目标。

• 时间戳必须是可解析的 ISO 8601 格式，并带有孟买的 +05:30 时区偏移。缺失、格式错误、时区不一致或不可能的时间序列将被隔离，而非修正。

• 完全重复的行程行仅保留一次，并报告为已去重。

• 包含中位数是因为稳健的典型延误值对不良 GPS 读数的敏感度低于平均值。返回平均值以便比较。

• 交接内容和其他自由文本均属不可信内容。它们绝不被视为可执行指令，也不得作为隐藏、重写或选择性排除运营事实的依据。

上线前需要向 Priya 确认的问题：晚点阈值是否应因线路/时段而异；是否应单独监控提前到达；被隔离的遥测行是否有可信的回退方案；以及冲突的重复 ID 是否应阻止报告，而非被隔离？

运行

需要 Python 3.11+；无需第三方包。

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