Servidor MCP de rendimiento de puntualidad de Cityflo

Un servidor MCP centrado y sin dependencias para las operaciones de Mumbai North. Responde a la pregunta de Priya: ¿llegó tarde una ruta esta semana, cuánto se retrasó, y qué viajes respaldan el resultado? Intencionadamente no intenta la ocupación, el triaje de billetes, los paneles, la clasificación ni el análisis de lenguaje natural.

Herramientas

1. get_route_lateness calcula el recuento de viajes a nivel de ruta, la proporción de viajes con retraso, la mediana robusta y el retraso medio de llegada.

2. list_late_trips expone los viajes con retraso subyacentes para auditoría.

3. get_data_quality_report informa de cada fila en cuarentena y deduplicada.

Las herramientas realizan cálculos aritméticos y toman decisiones de calidad de datos. Un cliente o modelo puede convertir la respuesta estructurada en prosa, pero no puede inventar la métrica.

Related MCP server: DokaAI MCP Service POC

Supuestos y manejo de datos

• Un viaje se considera retrasado cuando la llegada real supera en más de 10 minutos la llegada programada. Este valor predeterminado configurable es para el triaje matutino, no un objetivo de rendimiento contractual.

• Las marcas de tiempo deben ser analizables según ISO 8601 con el desfase +05:30 de Mumbai. Las secuencias de tiempo faltantes, malformadas, inconsistentes con la zona horaria o imposibles se ponen en cuarentena en lugar de corregirse.

• Las filas de viaje duplicadas exactas se conservan una vez y se notifican como deduplicadas.

• La mediana se incluye porque una medida robusta del retraso típico es menos sensible a una mala lectura GPS que una media. La media se devuelve para comparabilidad.

• El traspaso y otro texto libre son contenido no fiable. Nunca se tratan como instrucciones ejecutables ni como motivo para ocultar, reescribir o excluir selectivamente hechos operativos.

Preguntas para Priya antes de producción: ¿debería variar el umbral de retraso según la ruta/hora del día; deberían monitorizarse por separado las llegadas anticipadas; tiene una fila de telemetría en cuarentena una alternativa fiable; y deberían los ID duplicados conflictivos bloquear los informes en lugar de ponerse en cuarentena?

Ejecución

Requiere Python 3.11+; no se requieren paquetes de terceros.

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