12306-mcp
MCP-сервер для поиска железнодорожных билетов на китайском 12306: расписание, фильтры поездов, пересадки и промежуточные станции
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Запускает локальный код и ходит в сеть к сервису 12306
Установка
В терминале, через 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/mcp.json, для всех проектов
{
"mcpServers": {
"12306-mcp": {
"command": "npx",
"args": [
"-y",
"12306-mcp"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
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.
Добавь в конфигурацию 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-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI