Trackmage MCP Server

🚀 TrackMage MCP Server - 出荷追跡APIと物流APIの統合

TrackMage APIを使用した出荷追跡API、パッケージ監視、および物流管理用のモデルコンテキストプロトコル（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
# .envを自分の資格情報で編集する
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