{"id":49197781,"url":"https://github.com/dontsovcmc/mcp-server-cdek","last_synced_at":"2026-04-23T12:02:55.411Z","repository":{"id":352888558,"uuid":"1216431287","full_name":"dontsovcmc/mcp-server-cdek","owner":"dontsovcmc","description":"MCP сервер для личного кабинета юрлица СДЕК","archived":false,"fork":false,"pushed_at":"2026-04-21T16:32:05.000Z","size":45,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-04-21T16:33:44.010Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dontsovcmc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-20T22:39:52.000Z","updated_at":"2026-04-20T22:40:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dontsovcmc/mcp-server-cdek","commit_stats":null,"previous_names":["dontsovcmc/mcp-server-cdek"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/dontsovcmc/mcp-server-cdek","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-cdek","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-cdek/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-cdek/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-cdek/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dontsovcmc","download_url":"https://codeload.github.com/dontsovcmc/mcp-server-cdek/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-cdek/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32179389,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-23T11:42:27.955Z","status":"ssl_error","status_checked_at":"2026-04-23T11:42:18.877Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-23T12:02:54.772Z","updated_at":"2026-04-23T12:02:55.404Z","avatar_url":"https://github.com/dontsovcmc.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- mcp-name: io.github.dontsovcmc/cdek --\u003e\n\n# mcp-server-cdek\n\nMCP-сервер для работы с [API СДЭК v2](https://api-docs.cdek.ru/29923741.html) через Claude Code, Claude Desktop и другие MCP-совместимые клиенты.\n\nВсе данные остаются на вашем компьютере — ключи никуда не передаются.\n\n## Возможности\n\n### Доставка\n| Инструмент | Описание |\n|------------|----------|\n| `cdek_create_order` | Создать заказ на доставку (от меня / ко мне, на ПВЗ / до двери) |\n| `cdek_track` | Отследить заказ по номеру СДЭК |\n| `cdek_barcode` | Скачать PDF штрихкода для заказа |\n| `cdek_label` | Скачать этикетку (A4/A5/A6/A7, по умолчанию A6 ~70x120мм) |\n| `cdek_waybill` | Скачать PDF накладной для заказа |\n| `cdek_delivery_points` | Поиск ПВЗ в городе |\n| `cdek_cities` | Поиск городов СДЭК по названию |\n\n### Локальный справочник товаров\n| Инструмент | Описание |\n|------------|----------|\n| `goods_list` | Список всех товаров |\n| `goods_add` | Добавить товар (название, вес, габариты, цена) |\n| `goods_remove` | Удалить товар по названию |\n\nТовары хранятся локально в `~/.config/mcp-server-cdek/goods.json`. При создании заказа параметры берутся из справочника (если не указаны явно).\n\n## Настройка\n\n### Шаг 1. Получить ключи API СДЭК\n\n1. Зарегистрируйтесь в [личном кабинете СДЭК](https://lk.cdek.ru)\n2. Перейдите в **Настройки** → **Интеграция**\n3. Скопируйте **Client ID** и **Client Secret**\n\n### Шаг 2. Подключить MCP-сервер\n\n#### Claude Code (CLI в терминале)\n\n**Способ 1: через uvx** (не требует установки пакета)\n\n\u003e Требуется [uv](https://docs.astral.sh/uv/) — если не установлен:\n\u003e ```bash\n\u003e curl -LsSf https://astral.sh/uv/install.sh | sh\n\u003e ```\n\n```bash\nclaude mcp add cdek \\\n  -e CDEK_CLIENT=ваш_client_id \\\n  -e CDEK_SECRET=ваш_client_secret \\\n  -e CDEK_SENDER_COMPANY=\"ООО Ваша Компания\" \\\n  -e CDEK_SENDER_NAME=\"Иванов И.И.\" \\\n  -e CDEK_SENDER_FULL_NAME=\"Иванов Иван Иванович\" \\\n  -e CDEK_SENDER_EMAIL=\"delivery@example.com\" \\\n  -e CDEK_SENDER_PHONE=\"+79001234567\" \\\n  -- uvx mcp-server-cdek\n```\n\n**Способ 2: через pip**\n\n```bash\npip install mcp-server-cdek\n\nclaude mcp add cdek \\\n  -e CDEK_CLIENT=ваш_client_id \\\n  -e CDEK_SECRET=ваш_client_secret \\\n  -e CDEK_SENDER_COMPANY=\"ООО Ваша Компания\" \\\n  -e CDEK_SENDER_NAME=\"Иванов И.И.\" \\\n  -e CDEK_SENDER_FULL_NAME=\"Иванов Иван Иванович\" \\\n  -e CDEK_SENDER_EMAIL=\"delivery@example.com\" \\\n  -e CDEK_SENDER_PHONE=\"+79001234567\" \\\n  -- python -m mcp_server_cdek\n```\n\nДля удаления:\n```bash\nclaude mcp remove cdek\n```\n\n#### Claude Desktop (десктопное приложение)\n\nДобавьте в конфигурационный файл:\n\n| Клиент | ОС | Путь к файлу |\n|--------|----|-------------|\n| Claude Code | все | `~/.claude/settings.json` (секция `mcpServers`) |\n| Claude Desktop | macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Claude Desktop | Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n| Claude Desktop | Linux | `~/.config/Claude/claude_desktop_config.json` |\n\n```json\n{\n  \"mcpServers\": {\n    \"cdek\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-server-cdek\"],\n      \"env\": {\n        \"CDEK_CLIENT\": \"ваш_client_id\",\n        \"CDEK_SECRET\": \"ваш_client_secret\",\n        \"CDEK_SENDER_COMPANY\": \"ООО Ваша Компания\",\n        \"CDEK_SENDER_NAME\": \"Иванов И.И.\",\n        \"CDEK_SENDER_FULL_NAME\": \"Иванов Иван Иванович\",\n        \"CDEK_SENDER_EMAIL\": \"delivery@example.com\",\n        \"CDEK_SENDER_PHONE\": \"+79001234567\",\n        \"CDEK_MY_PVZ\": \"MSK123\"\n      }\n    }\n  }\n}\n```\n\n### Переменные окружения\n\n| Переменная | Обязательная | Описание |\n|-----------|:-----------:|----------|\n| `CDEK_CLIENT` | да | Client ID из личного кабинета СДЭК |\n| `CDEK_SECRET` | да | Client Secret из личного кабинета СДЭК |\n| `CDEK_SENDER_COMPANY` | да | Название компании отправителя |\n| `CDEK_SENDER_NAME` | да | Краткое имя отправителя |\n| `CDEK_SENDER_FULL_NAME` | да | Полное ФИО отправителя |\n| `CDEK_SENDER_EMAIL` | да | Email отправителя |\n| `CDEK_SENDER_PHONE` | да | Телефон отправителя |\n| `CDEK_MY_PVZ` | нет | Код вашего ПВЗ (для приёма посылок \"ко мне\") |\n| `CDEK_DEFAULT_PRODUCT_NAME` | нет | Название товара по умолчанию (Товар) |\n| `CDEK_DEFAULT_WEIGHT` | нет | Вес по умолчанию в кг (0.17) |\n| `CDEK_DEFAULT_HEIGHT` | нет | Высота по умолчанию в см (8) |\n| `CDEK_DEFAULT_WIDTH` | нет | Ширина по умолчанию в см (7) |\n| `CDEK_DEFAULT_LENGTH` | нет | Длина по умолчанию в см (10) |\n\n### Шаг 3. Проверить\n\nПопросите Claude: *«найди ПВЗ СДЭК в Москве на Тверской»* — он вызовет `cdek_delivery_points`.\n\n## Примеры (MCP)\n\n- «отправь посылку Иванову на ПВЗ MSK005, телефон +79001234567» → `cdek_create_order`\n- «отправь посылку до двери: Москва, Тверская 1, Петрову +79007654321» → `cdek_create_order`\n- «создай возвратный заказ от Сидорова, адрес: Самара, Ленина 10» → `cdek_create_order` (to_me)\n- «отследи посылку СДЭК 1234567890» → `cdek_track`\n- «скачай штрихкод для заказа 1234567890» → `cdek_barcode`\n- «скачай этикетку для заказа 1234567890» → `cdek_label`\n- «скачай этикетку A4 для заказа 1234567890» → `cdek_label` (format=A4)\n- «скачай накладную для заказа 1234567890» → `cdek_waybill`\n- «найди ПВЗ в Новосибирске» → `cdek_delivery_points`\n- «какие города СДЭК есть на \"Новосиб\"?» → `cdek_cities`\n- «добавь товар: Wi-Fi модем, 0.17 кг, 8x7x10 см» → `goods_add`\n- «список товаров» → `goods_list`\n\n## CLI-режим\n\nПакет можно использовать как CLI-инструмент в терминале. Без аргументов запускается MCP-сервер, с командой — CLI.\n\n### Требования\n\nПеременные окружения `CDEK_CLIENT`, `CDEK_SECRET` и данные отправителя должны быть установлены:\n\n```bash\nexport CDEK_CLIENT=ваш_client_id\nexport CDEK_SECRET=ваш_client_secret\nexport CDEK_SENDER_COMPANY=\"ООО Ваша Компания\"\nexport CDEK_SENDER_NAME=\"Иванов И.И.\"\nexport CDEK_SENDER_FULL_NAME=\"Иванов Иван Иванович\"\nexport CDEK_SENDER_EMAIL=\"delivery@example.com\"\nexport CDEK_SENDER_PHONE=\"+79001234567\"\n```\n\n### Команды\n\n```bash\n# Создать заказ (от меня на ПВЗ)\nmcp-server-cdek create-order --direction from_me --name \"Петров Пётр\" --phone \"+79007654321\" --pvz MSK005\n\n# Создать заказ (от меня до двери)\nmcp-server-cdek create-order --direction from_me --name \"Петров Пётр\" --phone \"+79007654321\" --address \"Москва, Тверская 1\"\n\n# Создать возвратный заказ (ко мне)\nmcp-server-cdek create-order --direction to_me --name \"Сидоров\" --phone \"+79009876543\" --address \"Самара, Ленина 10\"\n\n# Отследить заказ\nmcp-server-cdek track 1234567890\n\n# Скачать штрихкод\nmcp-server-cdek barcode 1234567890 --output /tmp/barcode.pdf\n\n# Скачать этикетку (по умолчанию A6 ~70x120мм)\nmcp-server-cdek label 1234567890 --output /tmp/label.pdf\nmcp-server-cdek label 1234567890 --output /tmp/label_a4.pdf --format A4\n\n# Скачать накладную\nmcp-server-cdek waybill 1234567890 --output /tmp/waybill.pdf\n\n# Поиск ПВЗ\nmcp-server-cdek delivery-points Москва --search Тверская\n\n# Поиск городов\nmcp-server-cdek cities Новосиб\n\n# Справочник товаров\nmcp-server-cdek goods list\nmcp-server-cdek goods add --name \"Wi-Fi модем\" --weight 0.17 --height 8 --width 7 --length 10\nmcp-server-cdek goods remove --name \"Wi-Fi модем\"\n```\n\nВсе команды выводят результат в JSON.\n\n## Лицензия\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdontsovcmc%2Fmcp-server-cdek","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdontsovcmc%2Fmcp-server-cdek","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdontsovcmc%2Fmcp-server-cdek/lists"}