TrackMage MCP Server

公式

TrackMage APIを通じた配送追跡APIと物流管理機能

GitHub
2

ドキュメント

TrackMage MCP Server - 配送追跡API & 物流API統合

TrackMage APIを使用した配送追跡API、荷物監視、物流管理のためのModel Context Protocol (MCP)サーバーです。世界1600以上の配送業者に対応しています。

機能

  • 配送業者サポート: 世界1600以上の配送業者に対応（全リスト）
  • リソース: ワークスペース、出荷、注文、配送業者、追跡ステータス
  • ツール: 出荷/注文の作成、出荷チェックポイントの取得、配送業者の検出
  • 認証: クライアント資格情報によるOAuth

⚠️ データプライバシーに関する注意

LLMプロバイダーとのデータ共有: このMCPサーバーは、使用しているLLM（Claude、ChatGPTなど）にデータを提供します。これはMCPサーバーの想定される動作ですが、追跡番号、顧客のメールアドレス、住所、出荷詳細などの物流データを選択したLLMプロバイダーと共有することに問題がないかご確認ください。

ベストプラクティス:

  • プライバシーに懸念がある場合は、機密性の低いデータまたはテストデータのみを使用してください
  • LLMプロバイダーのデータ取り扱いポリシーを確認してください
  • 可能であれば、トレーニングデータプログラムからのオプトアウトを検討してください
  • 組織のデータポリシーへの準拠を確認してください

前提条件

  • Node.js v18以上
  • TrackMageアカウント

認証情報の取得

  1. TrackMageに登録してログインします。
  2. 設定 > APIキーに移動します。
  3. アプリ名（例：「MCP」）とアプリURL（例：http://localhost:3000）を入力します。
  4. 生成をクリックし、クライアントIDとクライアントシークレットをコピーします。
  5. ダッシュボードURLからワークスペースIDをメモします。

インストール

オプション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