TrackMage

offiziell

Versandverfolgungs-API und Logistikmanagement-Funktionen über die TrackMage API

GitHub
2

Was kann man mit TrackMage MCP machen?

  • Sendung für die Nachverfolgung erstellen — Verwenden Sie create_shipment, um eine Sendungsnummer zu registrieren und optional einen Spediteur sowie eine Benachrichtigungs-E-Mail festzulegen.

  • Sendungsverfolgungs-Checkpoints abrufen — Rufen Sie detaillierte Checkpoint-Ereignisse für eine Sendung mit get_shipment_checkpoints ab.

  • Spediteur anhand einer Sendungsnummer erkennen — Verwenden Sie detect_carrier, um wahrscheinliche Spediteure zu finden, die zum Format einer Sendungsnummer passen.

  • Sendungen in einem Arbeitsbereich auflisten — Durchsuchen Sie Sendungen mit list_shipments, optional mit Paginierung und Arbeitsbereich-Filterung.

  • Mehrere Sendungen gleichzeitig erneut verfolgen — Lösen Sie die Nachverfolgung für mehrere Sendungsnummern gleichzeitig mit retrack_shipments erneut aus.

  • Bestellungen zusammen mit Sendungen verwalten — Erstellen, aktualisieren und listen Sie Bestellungen über create_order, update_order und list_orders.

Dokumentation

TrackMage MCP Server – Sendungsverfolgungs-API & Logistik-API-Integration

Ein Model Context Protocol (MCP) Server für die Sendungsverfolgungs-API, Paketüberwachung und Logistikverwaltung mit der TrackMage-API. Unterstützt die Verfolgung über mehr als 1600 Transportdienstleister weltweit.

Funktionen

  • Transportdienstleister-Unterstützung: Pakete über mehr als 1600 Transportdienstleister weltweit verfolgen (vollständige Liste)
  • Ressourcen: Arbeitsbereiche, Sendungen, Bestellungen, Transportdienstleister, Sendungsstatus
  • Werkzeuge: Sendungen/Bestellungen erstellen, Sendungs-Checkpoints abrufen, Transportdienstleister-Erkennung
  • Authentifizierung: OAuth mit Client-Anmeldedaten

⚠️ Datenschutzhinweis

Datenweitergabe an Ihren LLM-Anbieter: Dieser MCP-Server stellt Daten für das von Ihnen verwendete LLM (Claude, ChatGPT usw.) bereit. Dies ist zwar das erwartete Verhalten für MCP-Server, aber stellen Sie bitte sicher, dass Sie mit der Weitergabe von Logistikdaten wie Sendungsnummern, Kunden-E-Mails, Adressen und Sendungsdetails an Ihren gewählten LLM-Anbieter einverstanden sind.

Bewährte Praktiken:

  • Verwenden Sie bei Datenschutzbedenken nur nicht-sensible Daten oder Testdaten
  • Prüfen Sie die Richtlinien Ihres LLM-Anbieters zur Datenverarbeitung
  • Erwägen Sie, falls verfügbar, die Abmeldung von Trainingsdatenprogrammen
  • Stellen Sie die Einhaltung der Datenrichtlinien Ihrer Organisation sicher

Voraussetzungen

  • Node.js v18+
  • TrackMage-Konto

Zugangsdaten erhalten

  1. Registrieren Sie sich und melden Sie sich bei TrackMage an.
  2. Gehen Sie zu Einstellungen > API KEYS.
  3. Geben Sie einen App-Namen (z. B. „MCP“) und eine App-URL (z. B. http://localhost:3000) ein.
  4. Klicken Sie auf Generieren und kopieren Sie Ihre Client-ID und Ihr Client-Geheimnis.
  5. Notieren Sie Ihre Arbeitsbereichs-ID aus der Dashboard-URL.

Installation

Option 1: Lokale Einrichtung

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

Konfiguration

Bearbeiten Sie .env:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Verwendung

Starten Sie den Server:

npm start

und verwenden Sie dann

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

oder über den Dateiprozess:

{
  "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-Ressourcen

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

MCP-Werkzeuge

Sendungsverwaltung

  • create_shipment: Eine neue Sendung erstellen

    • Parameter: { trackingNumber, originCarrier?, email?, workspaceId? }
    • Rückgabe: Erstelltes Sendungsobjekt

  • update_shipment: Eine bestehende Sendung aktualisieren

    • Parameter: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Rückgabe: Aktualisiertes Sendungsobjekt

  • list_shipments: Sendungen aus dem Arbeitsbereich auflisten

    • Parameter: { workspaceId?, page?, itemsPerPage? }
    • Rückgabe: Array von Sendungsobjekten

  • get_shipment_checkpoints: Sendungs-Checkpoints für eine Sendung abrufen

    • Parameter: { shipmentId }
    • Rückgabe: Array von Sendungs-Checkpoint-Ereignissen

  • retrack_shipments: Mehrere Sendungen anhand von Sendungsnummern erneut verfolgen

    • Parameter: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Rückgabe: Ergebnisse der erneuten Verfolgung

Bestellverwaltung

  • create_order: Eine neue Bestellung erstellen

    • Parameter: { orderNumber, email?, workspaceId? }
    • Rückgabe: Erstelltes Bestellobjekt

  • update_order: Eine bestehende Bestellung aktualisieren

    • Parameter: { orderId, orderNumber?, email?, status? }
    • Rückgabe: Aktualisiertes Bestellobjekt

  • list_orders: Bestellungen aus dem Arbeitsbereich auflisten

    • Parameter: { workspaceId?, page?, itemsPerPage? }
    • Rückgabe: Array von Bestellobjekten

Transportdienstleister-Verwaltung

  • list_carriers: Verfügbare Transportdienstleister auflisten

    • Parameter: { page?, itemsPerPage? }
    • Rückgabe: Array von Transportdienstleister-Objekten mit Codes und Namen

  • detect_carrier: Mögliche Transportdienstleister für eine Sendungsnummer erkennen

    • Parameter: { trackingNumber }
    • Rückgabe: Array möglicher Transportdienstleister-Treffer

Tests

npm test