TrackMage MCP Server

官方

透過 TrackMage API 提供貨件追蹤 API 與物流管理功能

GitHub

文件

TrackMage MCP 伺服器 - 貨件追蹤 API 與物流 API 整合

一個使用 TrackMage API 的模型上下文協定 (MCP) 伺服器，用於貨件追蹤 API、包裹監控和物流管理。支援全球超過 1600 家貨運業者。

功能特色

貨運業者支援：追蹤全球超過 1600 家貨運業者的包裹（完整清單）
資源：工作區、貨件、訂單、貨運業者、追蹤狀態
工具：建立貨件/訂單、取得貨件檢查點、貨運業者偵測
驗證：使用客戶端憑證的 OAuth

⚠️ 資料隱私注意事項

與您的 LLM 提供者共享資料：此 MCP 伺服器會將資料提供給您正在使用的任何 LLM（Claude、ChatGPT 等）。雖然這是 MCP 伺服器的預期行為，但請確保您願意與所選的 LLM 提供者共享物流資料，包括追蹤號碼、客戶電子郵件、地址和貨件詳細資訊。

最佳做法：

如果您有隱私疑慮，請僅使用非敏感或測試資料
檢查您的 LLM 提供者的資料處理政策
如果可用，請考慮選擇退出訓練資料計畫
確保符合您組織的資料政策

先決條件

Node.js v18 以上版本
TrackMage 帳戶

取得憑證

註冊並登入 TrackMage。
前往 設定 > API 金鑰。
輸入應用程式名稱（例如 "MCP"）和應用程式網址（例如 http://localhost:3000）。
點擊產生並複製您的客戶端 ID 和客戶端密碼。
從儀表板網址記下您的工作區 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