io.github.ex3lite/mcp-rzd-tickets

Official

by ex3lite · TypeScript

RZD Tickets MCP

Read-only MCP server for RZD trains, cars, seats, adjacent pairs and car photos.

Read-only access to RZD train schedules, cars, seats, and car photos.

README.md10 KBView on GitHub

RZD Tickets MCP

Read-only MCP-сервер, который дает агентам живые “глаза” на ticket.rzd.ru: поезда, вагоны, цены, нижние/верхние места, боковые места, спецместа, соседние пары нижнее+верхнее, фото вагонов, когда РЖД их публикует, и официальные ссылки РЖД для ручного оформления.

Сервер не логинится, не бронирует, не создает холд, не оплачивает, не отменяет заказы и не меняет личный кабинет РЖД.

Инструменты

Инструмент	Что делает
`rzd_station_suggest`	Ищет `nodeId` и `expressCode` станции по названию.
`rzd_search_trains`	Показывает поезда, цены, группы вагонов и ссылку РЖД.
`rzd_train_cars`	Проваливается в `CarPricing`: вагоны, места, статистика верх/низ, фото.
`rzd_find_places`	Возвращает только совпадения по фильтрам, включая фото вагона.
`rzd_checkout_url`	Строит официальную ссылку РЖД для ручного оформления.
`rzd_parse_search_url`	Разбирает URL поиска РЖД.
`rzd_service_classes`	Объясняет, как читать открытые коды классов РЖД.

Установка

bash

git clone git@github.com:ex3lite/mcp_rzd_tickets.git
cd mcp_rzd_tickets
npm install
npm run build

Запуск MCP stdio-сервера:

bash

node dist/mcp.js

Быстрая CLI-проверка:

bash

node dist/cli.js --suggest "Красноярск"
node dist/cli.js --origin 2038000 --destination 2054275 --date 2026-07-12 --train 376Ы --require-pair --car-type coupe

Конфиг MCP-клиента

Пакет опубликован в npm как mcp-rzd-tickets, поэтому установка обычно не требует clone/build:

bash

npx -y mcp-rzd-tickets

Claude Code

Глобально для всех проектов:

bash

claude mcp add -s user rzd_tickets -- npx -y mcp-rzd-tickets
claude mcp list

Только для текущего проекта:

bash

claude mcp add -s project rzd_tickets -- npx -y mcp-rzd-tickets

Codex

bash

codex mcp add rzd_tickets --env RZD_TIMEOUT_MS=20000 -- npx -y mcp-rzd-tickets
codex mcp list

После изменения MCP-конфига уже открытой сессии Codex может понадобиться новый чат или перезапуск, чтобы сервер появился в списке инструментов.

Claude Desktop, Cursor, Windsurf, Cline, Roo Code

Для клиентов с JSON MCP-конфигом используй один и тот же блок:

json

{
  "mcpServers": {
    "rzd_tickets": {
      "command": "npx",
      "args": ["-y", "mcp-rzd-tickets"],
      "env": {
        "RZD_TIMEOUT_MS": "20000"
      }
    }
  }
}

Куда вставлять:

Клиент	Куда ставить
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json`, ключ `mcpServers`.
Cursor	`~/.cursor/mcp.json` глобально или `.cursor/mcp.json` в проекте.
Windsurf	Settings → Cascade/MCP → Add custom server, затем JSON выше.
Cline	MCP Servers → Configure MCP Servers или `~/.cline/mcp.json`.
Roo Code	MCP Servers → Edit Global MCP / Edit Project MCP.

Continue

Continue умеет читать JSON MCP config, но его родной формат — YAML block в .continue/mcpServers/rzd-tickets.yaml:

yaml

name: RZD Tickets MCP
version: 0.1.2
schema: v1
mcpServers:
  - name: rzd_tickets
    command: npx
    args:
      - -y
      - mcp-rzd-tickets

Локальный checkout

json

{
  "mcpServers": {
    "rzd_tickets": {
      "command": "node",
      "args": ["/absolute/path/to/mcp_rzd_tickets/dist/mcp.js"],
      "env": {
        "RZD_TIMEOUT_MS": "20000"
      }
    }
  }
}

Прокси

json

{
  "mcpServers": {
    "rzd_tickets": {
      "command": "npx",
      "args": ["-y", "mcp-rzd-tickets"],
      "env": {
        "RZD_PROXY_URL": "socks5://user:pass@host:1080",
        "RZD_TIMEOUT_MS": "20000"
      }
    }
  }
}

Прокси не нужен по умолчанию. Если RZD_PROXY_URL не задан, сервер ходит в РЖД напрямую.

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

text

Найди поезд 376Ы Красноярск Пасс — Анзеби на 2026-07-12.
Нужна соседняя пара нижнее+верхнее в купе.
Боковые и спецместа не учитывать.
Если есть совпадение, дай ссылку РЖД для оформления.

text

Через rzd_station_suggest найди коды Анзеби и Красноярск.
Потом проверь 2 пассажиров на 2026-07-03 по поезду 097Э.
Ищу пару нижнее+верхнее в одном отсеке.

Фильтры

trains: точные номера поездов, например ["097Э"].
departureFrom / departureTo: окно отправления HH:mm.
carType: coupe, platz или сырой тип РЖД.
service: сырой код класса РЖД, например 2Ш; список кодов открыт.
placeKind: lower, upper, other.
requirePair: соседняя пара нижнее+верхнее в одном отсеке.
includeSide: учитывать боковые места.
includeAccessible: учитывать спецместа для инвалидов/сопровождающих.
includeImages: подтягивать галерею вагона, если РЖД вернул HasImages=true; по умолчанию включено в MCP.
maxPrice, minPlaces: цена и минимальное количество мест.

Фото вагонов

В rzd_train_cars и rzd_find_places каждый вагон содержит imageInfo.

hasImages: флаг из CarPricing.
fetched: удалось ли сходить в endpoint галереи.
schemeId, schemeName, carSubType, carrier: идентификаторы схемы/типа вагона из РЖД.
images[].thumbnailUrl: миниатюра.
images[].contentUrl: полноразмерное фото.
unavailableReason / error: почему фото нет или запрос не удался.

Важно: у РЖД фото есть не для каждого вагона. Если в CarPricing HasImages=false, MCP не придумывает картинку и явно пишет причину в imageInfo.unavailableReason.

Классы вагонов РЖД

Класс обслуживания РЖД не моделируется как enum. Это намеренно.

РЖД может добавлять и менять коды, поэтому сервер отдает агенту:

code: сырой код РЖД, например 2Ш;
title: человекочитаемый заголовок из ответа РЖД, типа вагона или общего семейства;
tags: факты из официального ServiceClassTranscript и осторожные подсказки;
transcript: официальный текст РЖД, если он пришел в CarPricing;
description: готовая строка для показа человеку.

Агент должен показывать сырой код вместе с description, а точный смысл брать из transcript, когда он есть. Так не нужно расширять локальный enum каждый раз, когда РЖД вводит новый вариант.

Переменные окружения

Переменная	Описание
`RZD_PROXY_URL`	Опциональный `http://`, `https://`, `socks4://` или `socks5://` прокси.
`RZD_TIMEOUT_MS`	Таймаут запроса. По умолчанию `20000`.

Публикация

Основной путь:

bash

npm publish --access public
mcp-publisher login github
mcp-publisher publish

server.json уже подготовлен для официального MCP Registry: io.github.ex3lite/mcp-rzd-tickets. Сам registry хранит metadata, а код должен лежать в публичном npm-пакете mcp-rzd-tickets.

Дополнительно можно опубликовать на Smithery. Для текущего stdio-сервера нужен MCPB bundle; для URL-публикации на Smithery потребуется отдельный Streamable HTTP endpoint.

Языки

Ограничения

RZD может менять приватные web-endpoint без предупреждения. Этот сервер использует те же read-only pricing endpoint, что и публичный web-app, и браузероподобные заголовки. Если payload РЖД изменится, ошибка должна быть видна агенту, а не скрыта.

Install

Configuration

Environment variables

RZD_TIMEOUT_MS

Request timeout in milliseconds. Defaults to 20000.

RZD_PROXY_URLsecret

Optional http, https, socks4 or socks5 proxy URL. Leave empty for direct requests.

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-rzd-tickets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-rzd-tickets@0.1.2"
      ],
      "env": {
        "RZD_TIMEOUT_MS": "<YOUR_RZD_TIMEOUT_MS>",
        "RZD_PROXY_URL": "<YOUR_RZD_PROXY_URL>"
      }
    }
  }
}