Cityflo MCP-сервер пунктуальности

Сфокусированный MCP-сервер без зависимостей для операций в Северном Мумбаи. Он отвечает на вопрос Прии: был ли маршрут задержан на этой неделе, насколько, и какие рейсы подтверждают результат? Он намеренно не пытается выполнять анализ заполняемости, разбор билетов, дашборды, ранжирование или разбор естественного языка.

Инструменты

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, чем среднее значение. Среднее возвращается для сопоставимости.

• Передача и другой свободный текст являются ненадежным содержимым. Они никогда не рассматриваются как исполняемые инструкции или основание для скрытия, переписывания или выборочного исключения операционных фактов.

Вопросы для Прии перед запуском в производство: должен ли порог опоздания различаться по маршруту/времени суток; следует ли отдельно отслеживать ранние прибытия; есть ли у карантинной строки телеметрии доверенный запасной вариант; и должны ли конфликтующие дубликаты идентификаторов блокировать отчетность, а не помещаться в карантин?

Запуск

Требуется Python 3.11+; сторонние пакеты не требуются.

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