TrackMage

официальный

API отслеживания отправлений и возможности управления логистикой через TrackMage API

GitHub
2

Что можно делать с TrackMage MCP?

  • Создание отправления для отслеживания — Используйте create_shipment, чтобы зарегистрировать трек-номер и при необходимости указать перевозчика и email для уведомлений.

  • Получение контрольных точек отслеживания отправления — Получите подробные события контрольных точек для отправления с помощью get_shipment_checkpoints.

  • Определение перевозчика по трек-номеру — Используйте detect_carrier, чтобы найти вероятных перевозчиков, соответствующих формату трек-номера.

  • Список отправлений в рабочем пространстве — Просматривайте отправления с помощью list_shipments с возможностью пагинации и фильтрации по рабочему пространству.

  • Повторное отслеживание нескольких отправлений одновременно — Повторно запустите отслеживание для нескольких трек-номеров массово с помощью retrack_shipments.

  • Управление заказами вместе с отправлениями — Создавайте, обновляйте и просматривайте заказы через create_order, update_order и list_orders.

Документация

TrackMage MCP Server — API отслеживания отправлений и интеграция логистической API

Сервер Model Context Protocol (MCP) для API отслеживания отправлений, мониторинга посылок и управления логистикой с использованием TrackMage API. Поддерживает отслеживание по более чем 1600 перевозчикам по всему миру.

Возможности

  • Поддержка перевозчиков: Отслеживание посылок по более чем 1600 перевозчикам по всему миру (полный список)
  • Ресурсы: Рабочие пространства, отправления, заказы, перевозчики, статусы отслеживания
  • Инструменты: Создание отправлений/заказов, получение контрольных точек отправления, определение перевозчика
  • Аутентификация: OAuth с клиентскими учётными данными

⚠️ Уведомление о конфиденциальности данных

Передача данных вашему провайдеру LLM: Этот MCP-сервер предоставляет данные той LLM, которую вы используете (Claude, ChatGPT и т. д.). Хотя это ожидаемое поведение для MCP-серверов, пожалуйста, убедитесь, что вы готовы делиться логистическими данными, включая номера отслеживания, адреса электронной почты клиентов, адреса и детали отправлений, с выбранным вами провайдером LLM.

Рекомендации:

  • Используйте только с неконфиденциальными или тестовыми данными, если у вас есть опасения по поводу конфиденциальности
  • Проверьте политику обработки данных вашего провайдера LLM
  • Рассмотрите возможность отказа от программ обучения на данных, если это доступно
  • Обеспечьте соответствие политикам обработки данных вашей организации

Предварительные требования

  • Node.js v18+
  • Учётная запись TrackMage

Получение учётных данных

  1. Зарегистрируйтесь и войдите в TrackMage.
  2. Перейдите в Настройки > API KEYS.
  3. Введите Имя приложения (например, «MCP») и URL приложения (например, http://localhost:3000).
  4. Нажмите Сгенерировать и скопируйте ваш Client ID и Client Secret.
  5. Запишите ваш Workspace ID из URL панели управления.

Установка

Вариант 1: Локальная настройка

git clone https://github.com/yourusername/trackmage-mcp-server.git
cd trackmage-mcp-server
npm install
cp .env.example .env
# Edit .env with your credentials
npm start

Конфигурация

Отредактируйте .env:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

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

Запустите сервер:

npm start

а затем используйте

{
  "mcpServers": {
    "trackmage": {
      "transport": {
        "type": "http",
        "host": "localhost",
        "port": 3000
      }
    }
  }
}

или с помощью файлового процесса:

{
  "mcpServers": {

    "trackmage": {
      "command": "node",
      "args": ["/path/to/trackmage-mcp-server/index.js"],
      "env": {
        "TRACKMAGE_CLIENT_ID": "your_client_id_here",
        "TRACKMAGE_CLIENT_SECRET": "your_client_secret_here",
        "TRACKMAGE_WORKSPACE_ID": "your_workspace_id_here"
      }
    }

  }
}

Ресурсы MCP

  • trackmage:///workspaces/{id}
  • trackmage:///shipments/{id}
  • trackmage:///orders/{id}
  • trackmage:///carriers/{id}
  • trackmage:///tracking_statuses/{id}

Инструменты MCP

Управление отправлениями

  • create_shipment: Создать новое отправление

    • Параметры: { trackingNumber, originCarrier?, email?, workspaceId? }
    • Возвращает: Объект созданного отправления

  • update_shipment: Обновить существующее отправление

    • Параметры: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Возвращает: Объект обновлённого отправления

  • list_shipments: Список отправлений из рабочего пространства

    • Параметры: { workspaceId?, page?, itemsPerPage? }
    • Возвращает: Массив объектов отправлений

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

    • Параметры: { shipmentId }
    • Возвращает: Массив событий контрольных точек отслеживания

  • retrack_shipments: Повторно отследить несколько отправлений по номерам отслеживания

    • Параметры: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Возвращает: Результаты повторного отслеживания

Управление заказами

  • create_order: Создать новый заказ

    • Параметры: { orderNumber, email?, workspaceId? }
    • Возвращает: Объект созданного заказа

  • update_order: Обновить существующий заказ

    • Параметры: { orderId, orderNumber?, email?, status? }
    • Возвращает: Объект обновлённого заказа

  • list_orders: Список заказов из рабочего пространства

    • Параметры: { workspaceId?, page?, itemsPerPage? }
    • Возвращает: Массив объектов заказов

Управление перевозчиками

  • list_carriers: Список доступных перевозчиков

    • Параметры: { page?, itemsPerPage? }
    • Возвращает: Массив объектов перевозчиков с кодами и названиями

  • detect_carrier: Определить возможных перевозчиков для номера отслеживания

    • Параметры: { trackingNumber }
    • Возвращает: Массив возможных совпадений перевозчиков

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

npm test