English Français العربية

io.github.theYahia/pochta-russia-mcp

Registre officiel Recherche et web

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @theyahia/pochta-russia-mcp
Claude Code 
claude mcp add pochta-russia-mcp -e 'POCHTA_LOGIN=<your pochta_login>' -- npx -y @theyahia/pochta-russia-mcp@1.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pochta-russia-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/pochta-russia-mcp@1.0.1"
            ],
            "env": {
                "POCHTA_LOGIN": "<your pochta_login>"
            }
        }
    }
}

Variables d'environnement

  • POCHTA_LOGIN obligatoire secret API key for the service

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. MCP-сервер для Почты России — отслеживание посылок и расчёт доставки через ИИ
  2. Возможности (6 инструментов)
  3. Быстрый старт
  4. Переменные окружения
  5. Авторизация
  6. ⚠️ Миграция на 2.0.0 (breaking change)
  7. Надёжность
  8. Skills (Claude Code)
  9. Тесты
  10. Лицензия

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

Если вы искали, как отследить отправление Почты России по трек-номеру из чата, посчитать тариф и срок доставки или найти индекс и ближайшее отделение — это оно. 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)
{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": ["-y", "@theyahia/pochta-russia-mcp"],
      "env": {
        "POCHTA_TOKEN": "<ACCESS_TOKEN>",
        "POCHTA_LOGIN": "<LOGIN>",
        "POCHTA_PASSWORD": "<PASSWORD>"
      }
    }
  }
}
Claude Code
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
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 <от> <до> <вес>Полный расчёт с ближайшим отделением

Тесты

npm install
npm run typecheck
npm test

Лицензия

MIT

Telegram: @vhodvai

Questions fréquentes

Qu'est-ce que io.github.theYahia/pochta-russia-mcp ?

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

Comment installer io.github.theYahia/pochta-russia-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add pochta-russia-mcp -e 'POCHTA_LOGIN=<your pochta_login>' -- npx -y @theyahia/pochta-russia-mcp@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.theYahia/pochta-russia-mcp ?

Oui. Il attend POCHTA_LOGIN, à renseigner dans sa configuration.

io.github.theYahia/pochta-russia-mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.theYahia/pochta-russia-mcp ?

Il est publié par theYahia. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.