TrackMage MCP Server

resmi

Kemampuan API pelacakan pengiriman dan manajemen logistik melalui API TrackMage

GitHub
2

Dokumentasi

TrackMage MCP Server - API Pelacakan Pengiriman & Integrasi API Logistik

Server Model Context Protocol (MCP) untuk API pelacakan pengiriman, pemantauan paket, dan manajemen logistik menggunakan TrackMage API. Mendukung pelacakan di lebih dari 1600 kurir di seluruh dunia.

Fitur

  • Dukungan Kurir: Lacak paket di lebih dari 1600 kurir di seluruh dunia (daftar lengkap)
  • Sumber Daya: Ruang kerja, pengiriman, pesanan, kurir, status pelacakan
  • Alat: Buat pengiriman/pesanan, dapatkan pos pemeriksaan pengiriman, deteksi kurir
  • Autentikasi: OAuth dengan kredensial klien

⚠️ Pemberitahuan Privasi Data

Berbagi data dengan penyedia LLM Anda: Server MCP ini menyediakan data ke LLM mana pun yang Anda gunakan (Claude, ChatGPT, dll.). Meskipun ini adalah perilaku yang diharapkan untuk server MCP, pastikan Anda merasa nyaman berbagi data logistik termasuk nomor pelacakan, email pelanggan, alamat, dan detail pengiriman dengan penyedia LLM pilihan Anda.

Praktik terbaik:

  • Hanya gunakan dengan data non-sensitif atau data uji jika Anda memiliki kekhawatiran privasi
  • Periksa kebijakan penanganan data penyedia LLM Anda
  • Pertimbangkan untuk tidak ikut serta dalam program data pelatihan jika tersedia
  • Pastikan kepatuhan dengan kebijakan data organisasi Anda

Prasyarat

  • Node.js v18+
  • Akun TrackMage

Mendapatkan Kredensial

  1. Daftar dan masuk ke TrackMage.
  2. Buka Pengaturan > API KEYS.
  3. Masukkan Nama Aplikasi (mis., "MCP") dan URL Aplikasi (mis., http://localhost:3000).
  4. Klik Generate dan salin Client ID dan Client Secret Anda.
  5. Catat ID Ruang Kerja Anda dari URL dasbor.

Instalasi

Opsi 1: Pengaturan Lokal

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

Konfigurasi

Edit .env:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Penggunaan

Jalankan server:

npm start

lalu gunakan

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

atau menggunakan proses file:

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

  }
}

Sumber Daya MCP

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

Alat MCP

Manajemen Pengiriman

  • create_shipment: Buat pengiriman baru

    • Parameter: { trackingNumber, originCarrier?, email?, workspaceId? }
    • Mengembalikan: Objek pengiriman yang dibuat

  • update_shipment: Perbarui pengiriman yang ada

    • Parameter: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Mengembalikan: Objek pengiriman yang diperbarui

  • list_shipments: Daftar pengiriman dari ruang kerja

    • Parameter: { workspaceId?, page?, itemsPerPage? }
    • Mengembalikan: Array objek pengiriman

  • get_shipment_checkpoints: Dapatkan pos pemeriksaan pelacakan untuk pengiriman

    • Parameter: { shipmentId }
    • Mengembalikan: Array peristiwa pos pemeriksaan pelacakan

  • retrack_shipments: Lacak ulang beberapa pengiriman berdasarkan nomor pelacakan

    • Parameter: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Mengembalikan: Hasil pelacakan ulang

Manajemen Pesanan

  • create_order: Buat pesanan baru

    • Parameter: { orderNumber, email?, workspaceId? }
    • Mengembalikan: Objek pesanan yang dibuat

  • update_order: Perbarui pesanan yang ada

    • Parameter: { orderId, orderNumber?, email?, status? }
    • Mengembalikan: Objek pesanan yang diperbarui

  • list_orders: Daftar pesanan dari ruang kerja

    • Parameter: { workspaceId?, page?, itemsPerPage? }
    • Mengembalikan: Array objek pesanan

Manajemen Kurir

  • list_carriers: Daftar kurir yang tersedia

    • Parameter: { page?, itemsPerPage? }
    • Mengembalikan: Array objek kurir dengan kode dan nama

  • detect_carrier: Deteksi kurir yang mungkin untuk nomor pelacakan

    • Parameter: { trackingNumber }
    • Mengembalikan: Array kemungkinan kecocokan kurir

Pengujian

npm test