Pochta Russia Mcp

io.github.theYahia由 GitHub 帳號 theYahia 發布v1.0.1更新於 Oct 24, 2026

MCP server for Russian Post (Почта России) API — tracking, tariff calculation, post office search.

已驗證STDIO僅桌面位置與生活商業與電商

概覽

AI 產生的概覽

俄羅斯郵政 MCP 伺服器：在對話中查詢包裹物流、計算運費與時效、尋找郵局和郵遞區號。

可以做什麼
  • 依單號追蹤包裹並取得物流狀態
  • 計算寄往不同郵遞區號的運費與送達時間
  • 尋找郵局據點並查詢郵遞區號資訊
  • 透過俄羅斯郵政 API 正規化地址
適用情境
適合需要處理俄羅斯郵政寄件事務的情境：查詢包裹目前位置、估算運費和送達時間，或尋找附近郵局與郵遞區號，而不必手動填寫網頁表單。
執行需求
透過 npx（Node.js）以 stdio 在本機執行，也可加上連接埠參數以本機 HTTP 端點方式執行。需要俄羅斯郵政寄件人帳戶的 API 權限，並設定環境變數 POCHTA_TOKEN、POCHTA_LOGIN 與 POCHTA_PASSWORD；POCHTA_KEY 與 POCHTA_TIMEOUT_MS 為選用。需要能連線至俄羅斯郵政服務的網路。
安裝前請注意
需要你的俄羅斯郵政帳戶憑證：存取權杖、登入名稱與密碼以環境變數傳入，登入名稱與密碼會組合成 Basic 授權標頭。物流追蹤使用另一套 SOAP 服務，同樣需要登入名稱與密碼。請求與地址資料會傳送到俄羅斯郵政伺服器。2.0.0 版更改了憑證配置方式，舊的權杖加金鑰設定已不再適用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Pochta Russia Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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

其他 MCP 客戶端

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

README

MCP-сервер для Почты России — отслеживание посылок и расчёт доставки через ИИ

[npm] [CI] [License: MIT]

Если вы искали, как отследить отправление Почты России по трек-номеру из чата, посчитать тариф и срок доставки или найти индекс и ближайшее отделение — это оно. 6 инструментов: трекинг, расчёт стоимости и сроков, поиск отделений, индексы, нормализация адресов. Спрашиваете «где посылка 12345678901234» — получаете статус, а не страницу с капчей.

Возможности (6 инструментов)

ИнструментОписаниеЧто требуется
trackОтслеживание отправления по трек-номеруPOCHTA_LOGIN + POCHTA_PASSWORD (SOAP-трекинг)
calculateРасчёт стоимости и сроков доставкиPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
delivery_timeРасчёт сроков доставки между индексамиPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
get_officesПоиск почтовых отделенийPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
zip_lookupИнформация по почтовому индексуPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD
normalize_addressНормализация адреса через APIPOCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD

Быстрый старт

Claude Desktop / Cursor / Windsurf (stdio)

json
{  "mcpServers": {    "pochta": {      "command": "npx",      "args": ["-y", "@theyahia/pochta-russia-mcp"],      "env": {        "POCHTA_TOKEN": "<ACCESS_TOKEN>",        "POCHTA_LOGIN": "<LOGIN>",        "POCHTA_PASSWORD": "<PASSWORD>"      }    }  }}

Claude Code

bash
claude mcp add pochta \  -e POCHTA_TOKEN=<ACCESS_TOKEN> \  -e POCHTA_LOGIN=<LOGIN> \  -e POCHTA_PASSWORD=<PASSWORD> \  -- npx -y @theyahia/pochta-russia-mcp

Streamable HTTP

bash
npx @theyahia/pochta-russia-mcp --http --port=3000

MCP endpoint: http://localhost:3000/mcp Health check: http://localhost:3000/health → {"status":"ok","version":"…","tools":6}

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

ПеременнаяОбязательнаяОписание
POCHTA_TOKENДаAccess-токен приложения → заголовок Authorization: AccessToken …
POCHTA_LOGINДаЛогин кабинета → часть X-User-Authorization: Basic …
POCHTA_PASSWORDДаПароль кабинета → часть X-User-Authorization: Basic …
POCHTA_KEYНетBack-compat: готовый base64(login:password) для X-User-Authorization (вместо LOGIN/PASSWORD)
POCHTA_TIMEOUT_MSНетТаймаут запроса в мс (по умолчанию 15000)

Получите доступ к API: Кабинет отправителя → Настройки → API. Спецификация: https://otpravka.pochta.ru/specification.

Авторизация

REST-методы otpravka-api используют два заголовка (согласно официальной спецификации):

  • Authorization: AccessToken <POCHTA_TOKEN> — access-токен приложения;
  • X-User-Authorization: Basic <base64(POCHTA_LOGIN:POCHTA_PASSWORD)> — учётные данные кабинета.

Отслеживание (track) использует SOAP-API трекинга (tracking.russianpost.ru) и требует POCHTA_LOGIN + POCHTA_PASSWORD (access-токен там не применяется).

⚠️ Миграция на 2.0.0 (breaking change)

В версиях ≤ 1.x заголовки авторизации формировались неверно (access-токен и ключ были перепутаны местами), из-за чего REST-методы не проходили авторизацию. В 2.0.0 контракт исправлен:

  • Было: POCHTA_TOKEN + POCHTA_KEY. Этот набор больше не работает сам по себе.
  • Стало: POCHTA_TOKEN + POCHTA_LOGIN + POCHTA_PASSWORD.
  • POCHTA_KEY сохранён только как опциональный back-compat (готовый base64(login:password) для X-User-Authorization).

Надёжность

  • Повторные попытки (до 3) с экспоненциальной задержкой на сетевые ошибки, 429 и 5xx.
  • Таймаут запроса (по умолчанию 15 с, настраивается через POCHTA_TIMEOUT_MS).
  • Диагностические логи ретраев/ошибок пишутся в stderr (канал stdout занят MCP).

Skills (Claude Code)

КомандаОписание
/track <номер>Отследить посылку Почты России
/calculate <от> <до> <вес>Расчёт стоимости отправления
/parcel <от> <до> <вес>Полный расчёт с ближайшим отделением

Тесты

bash
npm installnpm run typechecknpm test

Лицензия

MIT

Telegram: @vhodvai

來源：README.md，提交 26cae85

工具

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

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

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

  • 已宣告認證方式10 分

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

  • 已列出工具15 分

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

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