mcp-server-12306

mcp-server-12306

drfccvMIT
337 звёзд57 форков
MCP-сервер для работы с официальным API китайских железных дорог 12306. Он открывает AI-ассистентам прямой доступ к данным о поездах, маршрутах, станциях, ценах и пересадках. Разработчики добавляют его в свои агенты, чтобы те могли искать билеты по Китаю в реальном времени — без парсинга сайтов и работы со сложными API. Сервер написан на Python с FastAPI, поддерживает стандарт MCP 2025-03-26 и работает в двух режимах: STDIO для локальных клиентов вроде Claude Desktop и HTTP для удалённой интеграции.
Search
Открыть на GitHub

Установка

uvx mcp-server-12306

Характеристики

Общее

  • СтатусСообщество
  • Разработчикdrfccv
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Искать поезда и свободные места. Инструмент query_tickets выдаёт маршруты, классы обслуживания и точное расписание по заданному направлению и дате.
  • Проверять цены на билеты. query_ticket_price возвращает актуальную стоимость билета для выбранного поезда, класса и маршрута.
  • Находить станции. search_stations ищет по названию, пиньиню или коду. Удобно для незнакомых городов.
  • Получать подробную информацию о станции. get_station_info показывает код станции, регион, широту и долготу.
  • Строить маршруты с пересадками. query_transfer автоматически подбирает оптимальные стыковочные рейсы для сложных направлений.
  • Смотреть полный маршрут поезда. get_train_route_stations выдаёт все остановки с временем прибытия, отправления и стоянки.
  • Определять текущее время в Китае. get_current_time помогает ассистенту корректно указывать даты в запросах, учитывая часовой пояс.

Как подключить

Сервер работает в двух режимах. Ниже — самый быстрый способ запустить его через STDIO.

Шаг 1. Установка

Выполните команду в терминале:

uvx mcp-server-12306

Если предпочитаете pipx:

pipx run --no-cache mcp-server-12306

Шаг 2. Конфигурация

Отредактируйте файл конфигурации MCP-клиента. Для Claude Desktop это claude_desktop_config.json. Вставьте JSON:

{ "mcpServers": { "12306": { "command": "uvx", "args": ["mcp-server-12306"] } } }

Для HTTP-режима (если запустили сервер отдельно):

{ "mcpServers": { "12306": { "url": "http://localhost:8000/mcp" } } }

Шаг 3. Перезапуск

Сохраните файл и перезапустите Claude Desktop. Готово, сервер появится в списке инструментов.

Примеры запросов

  • «Найди билеты из Пекина в Шанхай на послезавтра, бизнес-класс, покажи цены на все рейсы».
  • «Покажи все остановки поезда G1373, время прибытия и отправления на каждой станции».
  • «Найди станцию Нанкин, покажи её код, регион и координаты».
  • «Проложи маршрут из Шэньчжэня в Чэнду с одной пересадкой, выбери самый быстрый вариант по времени».
  • «Проверь точное время в Китае, мне нужно выбрать дату для завтрашнего запроса».

Технические детали

  • Язык разработки: Python (фреймворк FastAPI)
  • Транспортные протоколы: STDIO, Streamable HTTP
  • Версия протокола MCP: 2025-03-26
  • Лицензия: MIT (открытый исходный код)
  • Разработчик: drfccv (более 300 звёзд на GitHub)
  • Совместимые клиенты: Claude Desktop, Continue.dev, Cursor, любой другой MCP-клиент

Поделиться