TrackMage

TrackMage MCP Server - API Theo Dõi Vận Chuyển & Tích Hợp API Logistics

Một máy chủ Model Context Protocol (MCP) dành cho api theo dõi vận chuyển, giám sát bưu kiện và quản lý logistics sử dụng TrackMage API. Hỗ trợ theo dõi trên hơn 1600 nhà vận chuyển toàn cầu.

Tính năng

• Hỗ trợ nhà vận chuyển: Theo dõi bưu kiện trên hơn 1600 nhà vận chuyển toàn cầu (danh sách đầy đủ)
• Tài nguyên: Không gian làm việc, lô hàng, đơn hàng, nhà vận chuyển, trạng thái theo dõi
• Công cụ: Tạo lô hàng/đơn hàng, lấy điểm kiểm tra lô hàng, phát hiện nhà vận chuyển
• Xác thực: OAuth với thông tin xác thực khách hàng

⚠️ Thông báo về Quyền riêng tư Dữ liệu

Chia sẻ dữ liệu với nhà cung cấp LLM của bạn: Máy chủ MCP này cung cấp dữ liệu cho bất kỳ LLM nào bạn đang sử dụng (Claude, ChatGPT, v.v.). Mặc dù đây là hành vi được mong đợi đối với các máy chủ MCP, vui lòng đảm bảo bạn thoải mái chia sẻ dữ liệu logistics bao gồm số theo dõi, email khách hàng, địa chỉ và chi tiết lô hàng với nhà cung cấp LLM bạn đã chọn.

Thực hành tốt nhất:

• Chỉ sử dụng với dữ liệu không nhạy cảm hoặc dữ liệu thử nghiệm nếu bạn có lo ngại về quyền riêng tư
• Kiểm tra chính sách xử lý dữ liệu của nhà cung cấp LLM
• Cân nhắc từ chối các chương trình dữ liệu huấn luyện nếu có
• Đảm bảo tuân thủ chính sách dữ liệu của tổ chức bạn

Điều kiện tiên quyết

• Node.js v18+
• Tài khoản TrackMage

Lấy Thông tin Xác thực

1. Đăng ký và đăng nhập vào TrackMage.
2. Đi tới Cài đặt > API KEYS.
3. Nhập Tên Ứng dụng (ví dụ: "MCP") và URL Ứng dụng (ví dụ: http://localhost:3000).
4. Nhấp Tạo và sao chép Client ID và Client Secret của bạn.
5. Ghi lại ID Không gian làm việc từ URL bảng điều khiển.

Cài đặt

Tùy chọn 1: Thiết lập Cục bộ

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

Cấu hình

Chỉnh sửa .env:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Sử dụng

Chạy máy chủ:

npm start

và sau đó sử dụng

{
  "mcpServers": {
    "trackmage": {
      "transport": {
        "type": "http",
        "host": "localhost",
        "port": 3000
      }
    }
  }
}

hoặc sử dụng quy trình tệp:

{
  "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"
      }
    }

  }
}

Tài nguyên MCP

• trackmage:///workspaces/{id}
• trackmage:///shipments/{id}
• trackmage:///orders/{id}
• trackmage:///carriers/{id}
• trackmage:///tracking_statuses/{id}

Công cụ MCP

Quản lý Lô hàng

• create_shipment: Tạo một lô hàng mới

  • Tham số: { trackingNumber, originCarrier?, email?, workspaceId? }
  • Trả về: Đối tượng lô hàng đã tạo

• update_shipment: Cập nhật một lô hàng hiện có

  • Tham số: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
  • Trả về: Đối tượng lô hàng đã cập nhật

• list_shipments: Liệt kê các lô hàng từ không gian làm việc

  • Tham số: { workspaceId?, page?, itemsPerPage? }
  • Trả về: Mảng các đối tượng lô hàng

• get_shipment_checkpoints: Lấy các điểm kiểm tra theo dõi cho một lô hàng

  • Tham số: { shipmentId }
  • Trả về: Mảng các sự kiện điểm kiểm tra theo dõi

• retrack_shipments: Theo dõi lại nhiều lô hàng bằng số theo dõi

  • Tham số: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
  • Trả về: Kết quả theo dõi lại

Quản lý Đơn hàng

• create_order: Tạo một đơn hàng mới

  • Tham số: { orderNumber, email?, workspaceId? }
  • Trả về: Đối tượng đơn hàng đã tạo

• update_order: Cập nhật một đơn hàng hiện có

  • Tham số: { orderId, orderNumber?, email?, status? }
  • Trả về: Đối tượng đơn hàng đã cập nhật

• list_orders: Liệt kê các đơn hàng từ không gian làm việc

  • Tham số: { workspaceId?, page?, itemsPerPage? }
  • Trả về: Mảng các đối tượng đơn hàng

Quản lý Nhà vận chuyển

• list_carriers: Liệt kê các nhà vận chuyển có sẵn

  • Tham số: { page?, itemsPerPage? }
  • Trả về: Mảng các đối tượng nhà vận chuyển với mã và tên

• detect_carrier: Phát hiện các nhà vận chuyển có thể cho một số theo dõi

  • Tham số: { trackingNumber }
  • Trả về: Mảng các kết quả khớp nhà vận chuyển có thể

Kiểm thử

npm test