12306-mcp

MCP-сервер для поиска железнодорожных билетов на китайском 12306: расписание, фильтры поездов, пересадки и промежуточные станции

MCP-сервер

Средний риск

Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.

Почему такой уровень

  • Запускает локальный код и ходит в сеть к сервису 12306
Все причины и проверки

joooook/12306-mcp

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/12306-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio 12306-mcp -- npx -y 12306-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"12306-mcp","type":"stdio","command":"npx","args":["-y","12306-mcp"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "12306-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Выполните в терминале

codex mcp add 12306-mcp -- npx -y 12306-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.12306-mcp]
command = "npx"
args = ["-y", "12306-mcp"]

Если файл уже есть, допишите блок в конец.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "12306-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "12306-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "12306-mcp"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит ff6439d.

Текст для агента

Добавь в конфигурацию MCP сервер 12306-mcp с командой npx и аргументами -y 12306-mcp, затем перезапусти клиент. Для http-режима добавь аргумент --port и номер порта.

Другие способы из описания автора
npx -y 12306-mcp

Запуск в режиме stdio.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер дает агенту набор MCP-инструментов, которые обращаются к сервису 12306 и возвращают данные о поездах и билетах. Через него можно найти рейсы между станциями, отфильтровать поезда по нужным признакам, посмотреть маршрут с промежуточными станциями и подобрать варианты с пересадкой. Данные приходят структурированно, поэтому агент может дальше их сравнивать и объяснять. Сервер запускается локально по stdio или как http-сервис, ключи и регистрация не нужны.

Для кого. Для разработчиков и пользователей агентов, которым нужен доступ к расписанию и билетам железных дорог Китая прямо из диалога.

Подходит, если

  • Нужно найти поезда и билеты между двумя станциями в Китае
  • Нужно проверить маршрут с промежуточными станциями или вариант с пересадкой
  • Нужен структурированный ответ о рейсах для дальнейшего сравнения агентом

Не подходит, если

  • Нужна покупка или бронирование билета, а не только поиск
  • Нужны железные дороги других стран, кроме Китая

Пример запроса к агенту

Найди утренние поезда из Пекина в Шанхай на завтра и покажи время в пути

Ограничения

Сервер работает только с сервисом 12306 и только по поиску: покупки и бронирования он не делает. Автор отмечает, что проект учебный. Нужен Node.js 18 или новее, для отладки через MCP Inspector 2.0.0 требуется Node.js 22.19.0 или новее. Доступность данных зависит от самого 12306.

Как отключить. Удалите запись 12306-mcp из конфигурации MCP вашего клиента и перезапустите его.

MCP

Транспорт
stdio, http
Авторизация
не нужна

Проверка безопасности

  • Запускает локальный код и ходит в сеть к сервису 12306

Коротко о README

README представляет сервер поиска билетов 12306 на основе Model Context Protocol. В списке возможностей: запрос информации о билетах, фильтрация поездов, запрос по промежуточным станциям и по пересадкам. Показаны способы запуска: npx для stdio и http с указанием порта, сборка и запуск в Docker, а также фрагмент конфигурации mcpServers. Отдельно есть документация по принципу работы и архитектуре, автор указывает, что проект учебный. Лицензия MIT.

Частые вопросы

Можно ли купить билет через сервер?

Нет, сервер только ищет и показывает данные о поездах и билетах, покупка и бронирование не поддерживаются.

Нужен ли аккаунт 12306 или ключ?

Нет, для поиска ключи и вход в аккаунт не требуются.

Официальный

Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам

MCP-серверСредний риск46,5 тыс.Звезды репозитория
Выбор редакции

CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие

CLIВысокий риск31,2 тыс.Звезды репозитория
Выбор редакции

Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP

CLIСредний рискБез VPN30,1 тыс.Звезды репозитория
Выбор редакции

Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI

MCP-серверСредний риск28,1 тыс.Звезды репозитория
Foxx AI12306-mcp

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.