Skip to main content
Glama
Yandex Delivery MCP

Yandex Delivery MCP

by aryazansev

Yandex Delivery MCP Server

Deploy on Railway Deploy to Render

MCP (Model Context Protocol) сервер для интеграции с API Яндекс Доставки. Позволяет Claude и другим AI-ассистентам управлять доставками, отслеживать курьеров и работать с заказами.

🚀 Развернуть в интернете (1 минута)

Рекомендация: Railway - лучший бесплатный вариант

  • ⚡ Нажмите кнопку "Deploy on Railway" выше

  • 🔑 Добавьте API ключ Яндекс Доставки

  • 🌐 Получите рабочий URL: https://your-app.railway.app

  • 🎯 Используйте в AI Studio: https://your-app.railway.app/manifest

Related MCP server: Yandex AI Studio MCP Server

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

Установка через npm

npm install -g yandex-delivery-mcp

Или локальная установка

git clone https://github.com/aryazansev/-yandex-delivery-mcp.git
cd -yandex-delivery-mcp
npm install
npm run build

⚙️ Настройка

1. Получите API ключ из Яндекс Доставки

  1. Войдите в личный кабинет Яндекс Доставки

  2. Перейдите в раздел API / Интеграции

  3. Создайте новый API ключ

  4. Скопируйте ключ

2. Создайте файл конфигурации

Создайте файл ~/.yandex-delivery-mcp/.env:

mkdir -p ~/.yandex-delivery-mcp
cat > ~/.yandex-delivery-mcp/.env << 'EOF'
YANDEX_DELIVERY_API_KEY=your_api_key_here
MCP_PORT=3002
EOF

Или просто создайте .env файл в папке проекта:

YANDEX_DELIVERY_API_KEY=your_api_key_here
MCP_PORT=3002

3. Настройка (2 варианта)

Вариант A: Claude Desktop (локально)

Откройте файл конфигурации Claude Desktop:

macOS:

~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

Добавьте:

{
  "mcpServers": {
    "yandex-delivery": {
      "command": "yandex-delivery-mcp"
    }
  }
}

Вариант B: Внешний HTTP сервер (для AI Studio и других инструментов)

Запуск HTTP сервера:

npm run server

Сервер будет доступен на:

Для AI Studio:

  1. Запустите сервер: npm run server

  2. В AI Studio используйте URL: http://localhost:3002/manifest

  3. AI Studio автоматически обнаружит все доступные инструменты

4. Перезапустите Claude Desktop (если используете вариант A)

Полностью закройте и откройте заново Claude Desktop.

💬 Использование

Теперь вы можете спрашивать Claude о данных из Яндекс Доставки:

  • "Рассчитай стоимость доставки из Москвы в Санкт-Петербург"

  • "Создай заявку на доставку посылки 5 кг"

  • "Покажи статус заявки ABC123"

  • "Где сейчас курьер по заявке ABC123?"

  • "Получи телефон курьера для заявки ABC123"

  • "Найди все заявки за последние 3 дня"

  • "Отмени заявку ABC123"

🛠️ Доступные инструменты

Базовые операции

  • calculate_offers - Рассчитать варианты доставки

  • create_claim - Создать заявку на доставку

  • get_claim_info - Получить информацию о заявке

  • accept_claim - Подтвердить заявку

  • cancel_claim - Отменить заявку

Стоимость и тарифы

  • check_price - Проверить стоимость без создания заявки

  • get_tariffs - Получить доступные тарифы

Отслеживание

  • get_driver_phone - Получить номер телефона курьера

  • get_performer_position - Получить позицию курьера (координаты, скорость)

  • get_points_eta - Получить ETA для точек маршрута

  • get_tracking_links - Получить ссылки для отслеживания

Подтверждение доставки

  • get_confirmation_code - Получить код подтверждения

  • get_proof_of_delivery - Получить данные о подтверждении доставки

Редактирование

  • edit_claim - Редактировать заявку (до подтверждения)

  • apply_changes_request - Запросить изменения (после подтверждения)

  • apply_changes_result - Получить результат изменений

  • return_claim - Инициировать возврат заказа

Поиск и информация

  • search_claims - Поиск заявок с фильтрами

  • get_bulk_info - Получить информацию о нескольких заявках

  • get_claim_journal - Получить историю изменений заявки

Доставка в течение дня

  • get_delivery_methods - Получить список доступных услуг

🔧 Разработка

Сборка проекта

npm run build

Запуск в режиме разработки

# Для Claude Desktop (stdio)
npm run dev

# Для внешнего HTTP сервера (AI Studio)
npm run server

Тестирование через MCP Inspector

npx @modelcontextprotocol/inspector node build/index.js

Тестирование HTTP сервера

# Запустить сервер
npm run server

# Проверить эндпоинты в другой терминал
curl http://localhost:3002/health
curl http://localhost:3002/manifest
curl http://localhost:3002/tools

📝 Требования

  • Node.js 18+

  • API ключ от Яндекс Доставки

  • Claude Desktop (для интеграции с Claude)

📄 Лицензия

MIT License - см. файл LICENSE

🤝 Поддержка

Если у вас возникли проблемы:

  1. Проверьте, что API ключ активен

  2. Убедитесь, что у ключа есть нужные права доступа

  3. Проверьте логи Claude Desktop

  4. Создайте issue на GitHub

🔗 Ссылки

Пример использования

Создание заявки

{
  "route_points": [
    {
      "coordinates": [55.7558, 37.6173],
      "fullname": "Москва, Красная площадь, 1",
      "contact": {
        "name": "Иван",
        "phone": "+79991234567"
      }
    },
    {
      "coordinates": [59.9343, 30.3351],
      "fullname": "Санкт-Петербург, Невский проспект, 1",
      "contact": {
        "name": "Петр",
        "phone": "+79997654321"
      }
    }
  ],
  "items": [
    {
      "title": "Посылка",
      "weight": 5,
      "quantity": 1
    }
  ],
  "requirements": {
    "taxi_class": "express",
    "door_to_door": true
  }
}

Расчет стоимости

{
  "route_points": [
    {
      "coordinates": [55.7558, 37.6173]
    },
    {
      "coordinates": [59.9343, 30.3351]
    }
  ],
  "requirements": {
    "cargo_type": "van"
  }
}

Available Tools

21 tools
accept_claimD

Inputs: version (required), claim_id (required).

apply_changes_requestD

Inputs: changes (required), claim_id (required).

apply_changes_resultD

Inputs: claim_id (required).

calculate_offersD

Inputs: route_points (required), due, requirements, optional_return.

cancel_claimD

Inputs: version (required), claim_id (required), cancel_state.

check_priceD

Inputs: route_points (required), requirements, optional_return.

create_claimD

Inputs: route_points (required), due, items, comment, +2 more.

edit_claimD

Inputs: version (required), claim_id (required), items, comment, +1 more.

get_bulk_infoD

Inputs: claim_ids (required).

get_claim_infoD

Inputs: claim_id (required).

get_claim_journalD

Inputs: claim_id (required), cursor.

get_confirmation_codeD

Inputs: claim_id (required).

get_delivery_methodsD

Inputs: start_point.

get_driver_phoneD

Inputs: claim_id (required).

get_performer_positionD

Inputs: claim_id (required).

get_points_etaD

Inputs: claim_id (required).

get_proof_of_deliveryD

Inputs: claim_id (required).

get_tariffsD

Inputs: end_point, start_point.

return_claimD

Inputs: version (required), claim_id (required), point_id.

search_claimsD

Inputs: limit, phone, cursor, offset, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.8/5.0

    Scored across 21 tools

    Disambiguation3/5

    The tool set has several overlapping retrieval functions (e.g., get_claim_info, search_claims, get_bulk_info, get_claim_journal) and similar pricing tools (calculate_offers, check_price), which could confuse an agent without detailed descriptions. However, most tools are distinct actions on distinct resources.

    Naming Consistency4/5

    All tool names use snake_case and follow a verb_noun pattern (get_tracking_links, create_claim, accept_claim, etc.), which is consistent and readable. The only minor inconsistency is mixing singular and plural nouns (claim vs. claims, info vs. journal).

    Tool Count4/5

    With 21 tools, the server is slightly over the typical comfortable range but still reasonable for a comprehensive delivery management API covering claims, tracking, pricing, and delivery methods. Each tool appears to serve a distinct purpose, so the count is justified.

    Completeness4/5

    The tool surface covers the full claim lifecycle (create, edit, accept, cancel, return, search) and includes tracking, pricing, and delivery method operations, leaving few obvious gaps. Minor missing features like a dedicated 'delete' action are likely covered by cancel/return, so agents can achieve core workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Yandex Tracker API, enabling AI assistants to search, read, create, and edit issues, as well as manage comments, attachments, and links in Yandex Tracker.
      46 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Yandex Delivery B2B API, enabling natural language interaction to calculate delivery costs, create and manage express and platform delivery orders, track couriers, and handle pickup points.
      16
      104 npm
      MIT