物流追踪API服务

TrackMage MCP服务器-发货跟踪API和物流API集成

模型上下文协议（MCP）服务器，用于使用TrackMage api跟踪api、包裹监控和物流管理。支持全球1600多家运营商的跟踪。

特性

• 运营商支持：追踪全球1600多家运营商的包裹(完整列表)
• 资源：工作区、发货、订单、承运商、跟踪状态
• 工具：创建装运/订单，获取装运检查点，承运人检测
• 认证：具有客户端凭据的OAuth

⚠️ 数据隐私声明

与您的法学硕士提供者共享数据：此MCP服务器向您使用的任何LLM（Claude、ChatGPT等）提供数据。虽然这是MCP服务器的预期行为，但请确保您能够轻松地与您选择的LLM提供商共享物流数据，包括跟踪号、客户电子邮件、地址和装运详细信息。

最佳实践：

• 如果您有隐私问题，请仅使用非敏感或测试数据
• 检查LLM提供商的数据处理政策
• 考虑退出训练数据程序（如果可用）
• 确保符合组织的数据策略

先决条件

• Node.js v18+
• TrackMage帐户

获取凭据

1. 注册并登录 TrackMage.
2. 首选 设置>API密钥.
3. 输入一个 应用程序名称 （例如“MCP”）和 应用程序URL （例如。， http://localhost:3000).
4. 点击 生成 并复制您的 客户端ID 和 客户端密钥.
5. 注意你的 工作区ID 从仪表板URL。

安装

选项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