TrackMage

resmi

Kemampuan API pelacakan pengiriman dan manajemen logistik melalui API TrackMage

GitHub
2

Apa yang bisa Anda lakukan dengan TrackMage MCP?

  • Buat pengiriman untuk dilacak — Gunakan create_shipment untuk mendaftarkan nomor pelacakan dan secara opsional mengatur kurir serta email notifikasi.

  • Dapatkan titik pemeriksaan pelacakan pengiriman — Ambil peristiwa titik pemeriksaan terperinci untuk suatu pengiriman dengan get_shipment_checkpoints.

  • Deteksi kurir dari nomor pelacakan — Gunakan detect_carrier untuk menemukan kemungkinan kurir yang cocok dengan format nomor pelacakan.

  • Daftar pengiriman dalam ruang kerja — Jelajahi pengiriman dengan list_shipments, dengan opsi penomoran halaman dan penyaringan ruang kerja.

  • Lacak ulang beberapa pengiriman sekaligus — Picu ulang pelacakan untuk beberapa nomor pelacakan secara massal menggunakan retrack_shipments.

  • Kelola pesanan bersamaan dengan pengiriman — Buat, perbarui, dan daftar pesanan melalui create_order, update_order, dan list_orders.

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