Сервер MCP Shiplogic

Сервер Model Context Protocol (MCP), который обеспечивает бесшовную интеграцию с API Shiplogic Shipping. Создан с использованием MCP SDK и TypeScript для обеспечения безопасности типов и улучшения опыта разработчиков.

Демо

# Example conversation with Claude:
User: "Get shipping rates from Cape Town to Johannesburg for a 2.5kg parcel"
Claude: "I'll check shipping rates for you..."

[Using tool: get_shipping_rates]
Result: Economy service - R95 (2-3 days delivery)

User: "Book the economy service"
Claude: "Creating shipment..."

[Using tool: create_shipment]
Result: Shipment created! Tracking: QR4FVL

Функции

🚚 Получите стоимость доставки — рассчитайте стоимость доставки между адресами
📦 Создавайте отправки — заказывайте отправки с автоматическим отслеживанием
🔍 Отслеживание посылок — отслеживание отправлений в режиме реального времени
❌ Отмена поставок — отменяйте заказы при необходимости
➕ Дополнительные услуги — получите доступ к дополнительным тарифам на специальные услуги
📚 Управление адресной книгой — хранение и управление часто используемыми адресами

Установка

Предпосылки

Node.js 18+
npm или пряжа
Ключ API Shiplogic (получите его на shiplogic.com )

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

Клонировать и установить:

git clone https://github.com/jlwainwright/shiplogic-mcp.git
cd shiplogic-mcp
npm install

Настроить среду:

cp .env.example .env
# Edit .env and add your Shiplogic API key

Сборка сервера:

npm run build

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

С Клодом Десктопом

Добавьте это в конфигурацию вашего Claude Desktop:

{
  "mcpServers": {
    "shiplogic": {
      "command": "node",
      "args": ["/absolute/path/to/shiplogic-mcp/dist/index.js"],
      "env": {
        "SHIPLOGIC_API_KEY": "your_api_key_here"
      }
    }
  }
}

С инспектором MCP

Протестируйте сервер с помощью MCP Inspector:

npm run inspect

Автономный

Запустите сервер напрямую:

npm run dev

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

`get_shipping_rates`

Рассчитайте стоимость доставки между двумя адресами.

{
  collection_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  delivery_address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business"
  },
  parcels: [{
    length: number,    // cm
    width: number,     // cm
    height: number,    // cm
    weight: number,    // kg
    description?: string
  }],
  declared_value?: number
}

`create_shipment`

Создайте новую отправку с отслеживанием.

{
  service_level_code: string,  // e.g., "ECO"
  collection_address: { /* same as above */ },
  delivery_address: { /* same as above */ },
  parcels: [{ /* same as above */ }],
  collection_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  delivery_contact: {
    name: string,
    mobile_number?: string,
    email?: string
  },
  customer_reference?: string,
  mute_notifications?: boolean
}

`track_shipment`

Отслеживайте посылку по номеру отправления.

{
  tracking_number: string
}

`cancel_shipment`

Отменить существующую отправку.

{
  tracking_reference: string
}

`get_opt_in_rates`

Получите дополнительные тарифы на услуги.

{
  collection_address: { /* address object */ },
  delivery_address: { /* address object */ }
}

`add_address_to_book`

Добавьте адрес в адресную книгу учетной записи.

{
  account_id: number,
  address: {
    street_address: string,
    city: string,
    code: string,
    country?: string,
    type?: "residential" | "business",
    company?: string
  },
  name?: string,            // Name for this address entry
  type?: "collection" | "delivery"  // Address type
}

`get_address_book`

Извлечь адреса из адресной книги учетной записи.

{
  account_id: number,
  type?: "collection" | "delivery"  // Optional filter by type
}

`remove_address_from_book`

Удалить адрес из адресной книги учетной записи.

{
  account_id: number,
  address_id: number
}

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

Переменные среды:

Переменная	Описание	Необходимый	По умолчанию
`SHIPLOGIC_API_KEY`	Ваш ключ API Shiplogic	Да	-
`SHIPLOGIC_API_URL`	Базовый URL API	Нет	`https://api.shiplogic.com`

Разработка

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

shiplogic-mcp-official/
├── src/
│   └── index.ts        # Main server implementation
├── dist/               # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

Скрипты

npm run build — Компиляция TypeScript
npm run dev — сборка и запуск
npm run inspect — запуск с помощью MCP Inspector

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

# Run with MCP Inspector
npm run inspect

# In another terminal, test the tools
curl -X POST http://localhost:3000/tools/list

Ссылка на API

Этот сервер интегрируется с Shiplogic API v2. Подробную документацию API см.:

Лицензия

Лицензия MIT — см. файл ЛИЦЕНЗИЯ

Внося вклад

Форк репозитория
Создайте ветку функций ( git checkout -b feature/amazing-feature )
Зафиксируйте изменения ( git commit -m 'Add amazing feature' )
Отправка в ветку ( git push origin feature/amazing-feature )
Открыть запрос на извлечение

Поддерживать

🐛 Проблемы: Проблемы GitHub
📧 Электронная почта: your.email@example.com
📚 Документы: Wiki
☕ Поддержите мою работу: купите мне кофе

Если вы найдете этот проект полезным, рассмотрите возможность поддержки моей работы. Ваша поддержка помогает мне уделять больше времени разработке с открытым исходным кодом и создавать лучшие инструменты для сообщества.

Благодарности

Создано с помощью SDK Model Context Protocol
Работает на API Shiplogic

Сделано с ❤️ Жаком Уэйнрайтом

Shiplogic MCP Server

Integrations