Shiplogic MCP Server

Ein Model Context Protocol (MCP)-Server, der eine nahtlose Integration mit der Shiplogic-Versand-API ermöglicht. Erstellt mit dem MCP SDK und TypeScript für Typsicherheit und ein besseres Entwicklererlebnis.

Demo

# 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

Merkmale

🚚 Versandkosten abrufen - Versandkosten zwischen Adressen berechnen
📦 Sendungen erstellen - Sendungen mit automatischer Sendungsverfolgung buchen
🔍 Pakete verfolgen - Sendungsverfolgung in Echtzeit
❌ Sendungen stornieren - Stornieren Sie Buchungen bei Bedarf
➕ Optionale Leistungen - Zugang zu Zusatztarifen für besondere Leistungen
📚 Adressbuchverwaltung - Speichern und verwalten Sie häufig verwendete Adressen

Installation

Voraussetzungen

Node.js 18+
npm oder yarn
Shiplogic-API-Schlüssel (erhalten Sie einen unter shiplogic.com )

Schnellstart

Klonen und installieren:

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

Umgebung konfigurieren:

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

Erstellen Sie den Server:

npm run build

Verwendung

Mit Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration hinzu:

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

Mit MCP Inspector

Testen Sie den Server mit dem MCP Inspector:

npm run inspect

Standalone

Führen Sie den Server direkt aus:

npm run dev

Verfügbare Tools

`get_shipping_rates`

Berechnen Sie die Versandkosten zwischen zwei Adressen.

{
  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`

Erstellen Sie eine neue Sendung mit Sendungsverfolgung.

{
  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`

Verfolgen Sie eine Sendung anhand der Referenznummer.

{
  tracking_number: string
}

`cancel_shipment`

Stornieren Sie eine bestehende Sendung.

{
  tracking_reference: string
}

`get_opt_in_rates`

Erhalten Sie optionale Zusatzdiensttarife.

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

`add_address_to_book`

Fügen Sie dem Adressbuch des Kontos eine Adresse hinzu.

{
  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`

Rufen Sie Adressen aus dem Adressbuch des Kontos ab.

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

`remove_address_from_book`

Entfernen Sie eine Adresse aus dem Adressbuch des Kontos.

{
  account_id: number,
  address_id: number
}

Konfiguration

Umgebungsvariablen:

Variable	Beschreibung	Erforderlich	Standard
`SHIPLOGIC_API_KEY`	Ihr Shiplogic API-Schlüssel	Ja	-
`SHIPLOGIC_API_URL`	API-Basis-URL	NEIN	`https://api.shiplogic.com`

Entwicklung

Projektstruktur

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

Skripte

npm run build – TypeScript kompilieren
npm run dev – Erstellen und ausführen
npm run inspect – Ausführen mit MCP Inspector

Testen

# Run with MCP Inspector
npm run inspect

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

API-Referenz

Dieser Server ist mit der Shiplogic API v2 integriert. Eine ausführliche API-Dokumentation finden Sie hier:

Lizenz

MIT-Lizenz – siehe LICENSE -Datei

Beitragen

Forken Sie das Repository
Erstellen Sie Ihren Feature-Zweig ( git checkout -b feature/amazing-feature )
Änderungen festschreiben ( git commit -m 'Add amazing feature' )
Pushen zum Zweig ( git push origin feature/amazing-feature )
Öffnen einer Pull-Anfrage

Unterstützung

🐛 Probleme: GitHub-Probleme
📧 E-Mail: Ihre.E-Mail@Beispiel.com
📚 Dokumente: Wiki
☕ Unterstützen Sie meine Arbeit: Kaufen Sie mir einen Kaffee

Wenn Sie dieses Projekt hilfreich finden, unterstützen Sie meine Arbeit. Ihre Unterstützung hilft mir, mehr Zeit für die Open-Source-Entwicklung zu haben und bessere Tools für die Community zu entwickeln.

Danksagung

Erstellt mit Model Context Protocol SDK
Unterstützt durch die Shiplogic API

Mit ❤️ von Jacques Wainwright gemacht

Shiplogic MCP Server

Integrations