pochta-russia-mcp
MCP-сервер для API Почты России — отслеживание, расчёт тарифов, сроки доставки, поиск отделений, индексы, нормализация адресов.
Возможности (6 инструментов)
| Инструмент | Описание |
|---|---|
track | Отслеживание отправления по трек-номеру |
calculate | Расчёт стоимости и сроков доставки |
delivery_time | Расчёт сроков доставки между индексами |
get_offices | Поиск почтовых отделений |
zip_lookup | Информация по почтовому индексу |
normalize_address | Нормализация адреса через API |
Быстрый старт
Stdio (по умолчанию)
{
"mcpServers": {
"pochta": {
"command": "npx",
"args": ["-y", "@theyahia/pochta-russia-mcp"],
"env": {
"POCHTA_TOKEN": "<YOUR_ACCESS_TOKEN>",
"POCHTA_KEY": "<YOUR_API_KEY>"
}
}
}
}
Streamable HTTP
npx @theyahia/pochta-russia-mcp --http --port=3000
MCP endpoint: http://localhost:3000/mcp
Health check: http://localhost:3000/health
Переменные окружения
| Переменная | Обязательная | Описание |
|---|---|---|
POCHTA_TOKEN | Да | Access-токен для X-User-Authorization |
POCHTA_KEY | Да | API-ключ (Authorization header) |
Обратная совместимость
Также поддерживаются legacy-переменные:
| Переменная | Описание |
|---|---|
POCHTA_LOGIN | Логин от API (формирует Basic auth) |
POCHTA_PASSWORD | Пароль от API |
POCHTA_TOKEN | Access-токен |
Получите ключи: Кабинет отправителя -> Настройки -> API.
Авторизация
Сервер использует двойную авторизацию Почты России:
Authorization: API-ключ (POCHTA_KEY) или Basic auth (из POCHTA_LOGIN/PASSWORD)X-User-Authorization: accessToken <POCHTA_TOKEN>
Отслеживание использует SOAP API трекинга Почты России (login/password).
Skills (Claude Code)
| Команда | Описание |
|---|---|
/track <номер> | Отследить посылку Почты России |
/calculate <от> <до> <вес> | Расчёт стоимости отправления |
/parcel <от> <до> <вес> | Полный расчёт с ближайшим отделением |
Тесты
npm test
Лицензия
MIT