MCP-Server für die Pünktlichkeit von Cityflo

Ein fokussierter, abhängigkeitsfreier MCP-Server für den Betrieb in Mumbai North. Er beantwortet Priyas Frage: War eine Route diese Woche verspätet, um wie viel, und welche Fahrten stützen das Ergebnis? Er versucht bewusst nicht, Auslastung, Ticket-Triage, Dashboards, Rankings oder das Parsen natürlicher Sprache abzudecken.

Werkzeuge

1. get_route_lateness berechnet die Anzahl der Fahrten auf Routenebene, den Verspätungsanteil, den robusten Median und die mittlere Ankunftsverspätung.

2. list_late_trips stellt die zugrunde liegenden verspäteten Fahrten zur Prüfung bereit.

3. get_data_quality_report meldet jede unter Quarantäne gestellte und deduplizierte Zeile.

Die Werkzeuge führen Berechnungen durch und treffen Datenqualitätsentscheidungen. Ein Client oder ein Modell kann die strukturierte Antwort in Prosa umwandeln, aber die Kennzahl nicht erfinden.

Related MCP server: DokaAI MCP Service POC

Annahmen und Datenverarbeitung

• Eine Fahrt gilt als verspätet, wenn die tatsächliche Ankunft mehr als 10 Minuten nach der geplanten Ankunft liegt. Dieser konfigurierbare Standardwert dient der Morgen-Triage und ist kein vertragliches Leistungsziel.

• Zeitstempel müssen als ISO 8601 mit dem Offset +05:30 von Mumbai parsbar sein. Fehlende, fehlerhafte, zeitzoneninkonsistente oder unmögliche Zeitfolgen werden unter Quarantäne gestellt, statt korrigiert zu werden.

• Exakt doppelte Fahrtzeilen werden einmal behalten und als dedupliziert gemeldet.

• Der Median wird einbezogen, weil eine robuste typische Verspätung weniger empfindlich auf eine schlechte GPS-Messung reagiert als ein Durchschnitt. Der Mittelwert wird aus Vergleichbarkeitsgründen zurückgegeben.

• Die Übergabe und anderer Freitext sind nicht vertrauenswürdige Inhalte. Sie werden niemals als ausführbare Anweisungen oder als Grundlage dafür behandelt, operative Fakten zu verbergen, umzuschreiben oder selektiv auszuschließen.

Fragen an Priya vor dem Produktionsbetrieb: Sollte der Verspätungsschwellenwert je nach Route/Tageszeit variieren; sollten verfrühte Ankünfte separat überwacht werden; hat eine unter Quarantäne gestellte Telemetriezeile einen vertrauenswürdigen Fallback; und sollten widersprüchliche doppelte IDs die Berichterstattung blockieren, statt unter Quarantäne gestellt zu werden?

Ausführen

Erfordert Python 3.11+; es sind keine Pakete von Drittanbietern erforderlich.

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