Сервер MCP для запроса билетов на поезд (FastMCP)

Сервис запроса билетов на поезда/высокоскоростные поезда, реализованный с помощью FastMCP, может использоваться в качестве удаленного MCP-инструмента, вызываемого любым агентом (например, deepagents, LangGraph, Claude и т.д.).

Возможности

Одна функция-инструмент: query_train_tickets(from_station, to_station, date)

• Запрос рейсов, времени отправления и прибытия, продолжительности, статуса бронирования и наличия билетов между двумя станциями на определенную дату

• Источник данных: открытый интерфейс запросов 12306 (реальные данные); при блокировке интерфейса автоматически переключается на имитационные данные с четким указанием источника, что гарантирует демонстрацию в любое время

Related MCP server: YHT Bilet MCP Server

Локальный запуск

pip install -r requirements.txt
python server.py        # 启动 streamable-http 服务，默认 http://127.0.0.1:8000

Конфигурация клиента MCP (локальная отладка):

{
  "mcpServers": {
    "train": {
      "url": "http://127.0.0.1:8000/mcp/",
      "transport": "streamable_http"
    }
  }
}

Развертывание на MCP-площадке ModelScope (ключевые шаги)

1. Отправьте этот репозиторий на GitHub

2. Откройте modelscope.cn/mcp, войдите в систему → нажмите «Создать MCP»

3. Выберите тип создания «Быстрое создание через GitHub»; тип хостинга выберите «Хостинг с возможностью развертывания»

4. Заполните название на английском/китайском языке, адрес источника (URL репозитория GitHub), дополните конфигурацию по подсказкам платформы

5. После отправки платформа сгенерирует адрес доступа: https://mcp.api-inference.modelscope.net/<ваш_ID>/sse или /mcp (можно настроить бессрочное действие)

6. Вставьте этот адрес в конфигурацию MCP вашего проекта агента

Подсказка: Платформа предъявляет требования к способу запуска хостинговых проектов (обычно требуется Python + запуск HTTP-сервиса). В случае сбоя развертывания настройте точку входа по подсказкам платформы (например, предоставьте скрипт run или переменные окружения).

Описание источника данных

• У 12306 нет официального открытого API. В этом проекте используется его открытый интерфейс запросов (kyfw.12306.cn/otn/leftTicket), запросы без авторизации, только для личного изучения и исследований

• Интерфейс имеет защиту от злоупотреблений (изредка 302), в коде реализована подстраховка с помощью сессионных cookie + имитационных данных

• Для более стабильных данных вы можете самостоятельно заменить _fetch_12306 на сторонний источник данных (подключаемый)

Содержание

• server.py — основная программа сервиса FastMCP

• test_client.py — скрипт локальной отладки (прямой вызов функций-инструментов + тестирование по протоколу MCP)

• requirements.txt — зависимости