MCP Server 12306

MCP Server 12306

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

Подключить MCP Server 12306

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Клиент запускает MCP-сервер как локальный процесс.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "mcp-server-12306": {
      "command": "uvx",
      "args": [
        "mcp-server-12306"
      ]
    }
  }
}

Сгенерировано из существующей команды запуска. Желательно сверить с README.

Инструкция собрана из данных карточки и пока не отмечена как проверенная редакцией. Сверьте команду с README источника и не передавайте лишние права или секреты.

Как оценить MCP Server 12306

MCP Server 12306 относится к Поиск. Ниже собраны проверяемые признаки, по которым его можно сравнить с другими серверами каталога.

Происхождение
Проект сообщества
Лицензия
MIT
Реализация
Python
Транспорт
stdio

Что проверить перед выбором

  • Изучите README, открытые issues и историю последних изменений в репозитории.
  • Проверьте команду установки и зависимости перед запуском в рабочем окружении.
  • Ограничьте доступ MCP-сервера только нужными файлами, API и переменными окружения.

Карточка отредактирована 20.07.2026.

Автоматическая проверка источника ещё не выполнена. Внешних источников в карточке: 1.

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

Общее

  • СтатусСообщество
  • Разработчик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-клиент

Поделиться