TrackMage

officiel

API de suivi des expéditions et fonctionnalités de gestion logistique via l'API TrackMage

GitHub
2

Que pouvez-vous faire avec TrackMage MCP ?

  • Créer un envoi pour le suivi — Utilisez create_shipment pour enregistrer un numéro de suivi et éventuellement définir un transporteur et un e-mail de notification.

  • Obtenir les points de contrôle de suivi d’un envoi — Récupérez les événements de point de contrôle détaillés d’un envoi avec get_shipment_checkpoints.

  • Détecter un transporteur à partir d’un numéro de suivi — Utilisez detect_carrier pour trouver les transporteurs probables correspondant au format d’un numéro de suivi.

  • Lister les envois dans un espace de travail — Parcourez les envois avec list_shipments, avec pagination facultative et filtrage par espace de travail.

  • Relancer le suivi de plusieurs envois à la fois — Déclenchez à nouveau le suivi de plusieurs numéros de suivi en masse à l’aide de retrack_shipments.

  • Gérer les commandes parallèlement aux envois — Créez, mettez à jour et listez les commandes via create_order, update_order et list_orders.

Documentation

Serveur MCP TrackMage – API de suivi d’expéditions & intégration d’API logistique

Un serveur Model Context Protocol (MCP) pour l’API de suivi d’expéditions, la surveillance de colis et la gestion logistique via l’API TrackMage. Compatible avec plus de 1600 transporteurs dans le monde.

Fonctionnalités

  • Prise en charge des transporteurs : Suivez vos colis auprès de plus de 1600 transporteurs dans le monde (liste complète)
  • Ressources : Espaces de travail, expéditions, commandes, transporteurs, statuts de suivi
  • Outils : Créer des expéditions/commandes, obtenir les points de contrôle d’une expédition, détection du transporteur
  • Authentification : OAuth avec identifiants client

⚠️ Avis de confidentialité des données

Partage de données avec votre fournisseur de LLM : Ce serveur MCP fournit des données au LLM que vous utilisez (Claude, ChatGPT, etc.). Bien qu’il s’agisse du comportement attendu pour les serveurs MCP, veuillez vous assurer que vous êtes à l’aise avec le partage de données logistiques (numéros de suivi, e-mails clients, adresses et détails d’expédition) avec le fournisseur de LLM choisi.

Bonnes pratiques :

  • Utilisez uniquement des données non sensibles ou de test si vous avez des préoccupations en matière de confidentialité
  • Vérifiez les politiques de traitement des données de votre fournisseur de LLM
  • Envisagez de vous désinscrire des programmes d’entraînement sur les données si disponibles
  • Assurez la conformité avec les politiques de données de votre organisation

Prérequis

  • Node.js v18+
  • Compte TrackMage

Obtention des identifiants

  1. Inscrivez-vous et connectez-vous à TrackMage.
  2. Allez dans Paramètres > API KEYS.
  3. Saisissez un Nom d’application (ex. : « MCP ») et une URL d’application (ex. : http://localhost:3000).
  4. Cliquez sur Generate et copiez votre Client ID et votre Client Secret.
  5. Notez votre Workspace ID depuis l’URL du tableau de bord.

Installation

Option 1 : Configuration locale

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

Configuration

Modifiez .env :

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Utilisation

Lancez le serveur :

npm start

puis utilisez

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

ou via un processus fichier :

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

  }
}

Ressources MCP

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

Outils MCP

Gestion des expéditions

  • create_shipment : Créer une nouvelle expédition

    • Paramètres : { trackingNumber, originCarrier?, email?, workspaceId? }
    • Retourne : L’objet expédition créé

  • update_shipment : Mettre à jour une expédition existante

    • Paramètres : { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Retourne : L’objet expédition mis à jour

  • list_shipments : Lister les expéditions d’un espace de travail

    • Paramètres : { workspaceId?, page?, itemsPerPage? }
    • Retourne : Tableau d’objets expédition

  • get_shipment_checkpoints : Obtenir les points de contrôle de suivi d’une expédition

    • Paramètres : { shipmentId }
    • Retourne : Tableau d’événements de points de contrôle de suivi

  • retrack_shipments : Relancer le suivi de plusieurs expéditions par numéros de suivi

    • Paramètres : { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Retourne : Résultats de la relance de suivi

Gestion des commandes

  • create_order : Créer une nouvelle commande

    • Paramètres : { orderNumber, email?, workspaceId? }
    • Retourne : L’objet commande créé

  • update_order : Mettre à jour une commande existante

    • Paramètres : { orderId, orderNumber?, email?, status? }
    • Retourne : L’objet commande mis à jour

  • list_orders : Lister les commandes d’un espace de travail

    • Paramètres : { workspaceId?, page?, itemsPerPage? }
    • Retourne : Tableau d’objets commande

Gestion des transporteurs

  • list_carriers : Lister les transporteurs disponibles

    • Paramètres : { page?, itemsPerPage? }
    • Retourne : Tableau d’objets transporteur avec codes et noms

  • detect_carrier : Détecter les transporteurs possibles pour un numéro de suivi

    • Paramètres : { trackingNumber }
    • Retourne : Tableau de correspondances de transporteurs possibles

Tests

npm test