mcp-server-12306 — MCP-сервер для Claude Code: запросы к 12306
Позволяет через MCP запрашивать расписания, цены билетов, пересадки и станции железных дорог Китая из интерфейса 12306.
MIT ★ 426 обновлён 2026-09-30
claude mcp add mcp-server-12306 -- uvx mcp-server-12306Что делает mcp-server-12306
Сервер предоставляет семь инструментов: поиск остатков билетов с фильтрацией по номеру поезда, запрос цен на все типы мест (от бизнес-класса до сидячих), поиск станций по названию или коду (включая пиньинь и сокращения), расчёт маршрутов с пересадками, список остановок конкретного поезда, получение внутреннего идентификатора поезда и вывод текущего времени в нужном часовом поясе. Работает в двух режимах: stdio (подключается локально через стандартный ввод-вывод) и HTTP (поднимает веб-сервер на порту 8000 для удалённого доступа). Требует Python 3.10 или новее; установить можно через uvx, pip или Docker-образ drfccv/mcp-server-12306.
База станций загружается из файла station_name.js в ресурсах проекта. HTTP-режим открывает дополнительные эндпоинты: /health показывает число загруженных станций и активных сессий, /schema/tools отдаёт JSON Schema всех инструментов, / возвращает версию и список эндпоинтов. Конфигурация через переменные окружения (SERVER_HOST, SERVER_PORT, LOG_LEVEL) или файл .env.
Какие задачи решает
- запросить остатки мест на поезд между двумя городами Китая
- узнать цены билетов на все классы обслуживания
- найти станцию по китайскому названию или трёхбуквенному коду
- построить маршрут с пересадками через официальный API 12306
- получить расписание остановок конкретного поезда
Примеры запросов агенту
- Покажи остатки билетов из Пекина в Шанхай на завтра
- Сколько стоит бизнес-класс на поезд G123 из Гуанчжоу в Шэньчжэнь 15 мая?
- Найди станцию по коду BJP
Как установить mcp-server-12306
Командой платформы
claude mcp add mcp-server-12306 -- uvx mcp-server-12306uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-12306 <команда>
Командой платформы
codex mcp add mcp-server-12306 -- uvx mcp-server-12306uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-12306 <команда>
Файл настроек
{
"mcpServers": {
"mcp-server-12306": {
"command": "uvx",
"args": [
"mcp-server-12306"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-12306 <команда>
Файл настроек
{
"servers": {
"mcp-server-12306": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-server-12306"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-12306 <команда>
Командой платформы
gemini mcp add mcp-server-12306 uvx mcp-server-12306uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-12306 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-server-12306
Как установить mcp-server-12306 в Claude Code?
Выполни команду claude mcp add mcp-server-12306 -- uvx mcp-server-12306. Сервер подключится через stdio и станет доступен в интерфейсе Claude Code.
Что делает mcp-server-12306?
Подключает к агенту семь инструментов для работы с API 12306: поиск билетов, цен, станций, пересадок, расписаний поездов и текущего времени. Данные берутся из официальных интерфейсов системы бронирования железных дорог Китая.
Нужен ли ключ API для работы с mcp-server-12306?
Нет. Сервер обращается к публичным эндпоинтам 12306 без авторизации. Требуется только сетевой доступ к этим интерфейсам и Python 3.10 или новее.