Trackmage MCP Server

🚀 TrackMage MCP服務器 - 貨運跟蹤API與物流API集成

TrackMage MCP服務器藉助TrackMage API，實現了貨運跟蹤API、包裹監控和物流管理功能。它支持全球1600多家承運商的包裹跟蹤。

✨ 主要特性

• 承運商支持：可跟蹤全球1600多家承運商的包裹（完整列表）
• 資源管理：支持工作區、貨運、訂單、承運商和跟蹤狀態等資源的管理
• 實用工具：可創建貨運/訂單、獲取貨運檢查點信息以及進行承運商檢測
• 身份驗證：支持使用客戶端憑證進行OAuth認證

⚠️ 數據隱私聲明

⚠️ 重要提示

與您的大語言模型（LLM）提供商共享數據：此MCP服務器會將數據提供給您使用的任何大語言模型（如Claude、ChatGPT等）。雖然這是MCP服務器的預期行為，但請確保您願意與所選的大語言模型提供商共享物流數據，包括跟蹤號碼、客戶電子郵件、地址和貨運詳情。

最佳實踐：

• 如果您有隱私顧慮，僅使用非敏感或測試數據。
• 查看您的大語言模型提供商的數據處理政策。
• 如果有可用選項，考慮退出訓練數據計劃。
• 確保符合您所在組織的數據政策。

📦 安裝指南

前提條件

• 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