RZD Tickets MCP

io.github.ex3lite由 GitHub 帳號 ex3lite 發布v0.1.2更新於 Oct 27, 2026

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

概覽

AI 產生的概覽

唯讀 MCP 伺服器,讓助理查詢俄羅斯鐵路(RZD)的列車、車廂、座位、價格與車廂照片,並產生官方訂票連結。

可以做什麼
  • 依名稱查詢車站,取得 nodeId 與 expressCode
  • 搜尋列車,顯示價格、車廂分組與 RZD 官方連結
  • 檢視某班列車的車廂:座位、上/下鋪統計與車廂照片
  • 依車次、發車時段、車廂類型、服務等級、座位類型、相鄰下鋪+上鋪、側鋪或無障礙座位、價格與最少座位數篩選座位
  • 產生 RZD 官方結帳連結供手動訂票,並解析 RZD 搜尋網址
  • 說明如何解讀 RZD 公開的服務等級代碼
適用情境
適合讓助理不必離開對話就能查詢 RZD 車次空位、座位配置與價格,或找出特定的相鄰下鋪+上鋪組合。它只讀取資料並提供官方連結,適合行程規劃與研究,而非直接訂票。
執行需求
以 stdio 方式在使用者本機執行,通常透過 npx 使用 npm 套件 mcp-rzd-tickets(需要 Node.js),也可從本機建置執行。需要能連線至 RZD 的網路端點。選用環境變數:RZD_PROXY_URL 指定 http、https、socks4 或 socks5 代理,RZD_TIMEOUT_MS 設定請求逾時(預設 20000)。不需帳號或登入。
安裝前請注意
它使用模擬瀏覽器的標頭存取 RZD 的私有唯讀網頁端點,RZD 可能隨時變更,結果可能失效。RZD_PROXY_URL 可能內含代理憑證並寫入用戶端設定。它不會登入、訂票、保留座位、付款、取消或變更你的 RZD 帳戶;訂票須透過它回傳的官方連結手動完成。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 RZD Tickets MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[RZD Tickets MCP logo]

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 [email protected]:ex3lite/mcp_rzd_tickets.gitcd mcp_rzd_ticketsnpm installnpm 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-ticketsclaude 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-ticketscodex 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 в проекте.
WindsurfSettings → Cascade/MCP → Add custom server, затем JSON выше.
ClineMCP Servers → Configure MCP Servers или ~/.cline/mcp.json.
Roo CodeMCP Servers → Edit Global MCP / Edit Project MCP.

Continue

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

yaml
name: RZD Tickets MCPversion: 0.1.2schema: v1mcpServers:  - 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 publicmcp-publisher login githubmcp-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 РЖД изменится, ошибка должна быть видна агенту, а не скрыта.

來源:README.md,提交 caed034

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分