TrackMage

resmi

TrackMage API üzerinden kargo takip API'si ve lojistik yönetimi yetenekleri

GitHub
2

TrackMage MCP ile neler yapabilirsiniz?

  • Takip için bir gönderi oluşturun — Bir takip numarası kaydetmek ve isteğe bağlı olarak bir kargo şirketi ve bildirim e-postası ayarlamak için create_shipment kullanın.

  • Gönderi takip kontrol noktalarını alın — get_shipment_checkpoints ile bir gönderi için ayrıntılı kontrol noktası olaylarını alın.

  • Bir takip numarasından kargo şirketini tespit edin — Bir takip numarası formatıyla eşleşen olası kargo şirketlerini bulmak için detect_carrier kullanın.

  • Bir çalışma alanındaki gönderileri listeleyin — İsteğe bağlı sayfalama ve çalışma alanı filtrelemesi ile list_shipments kullanarak gönderilere göz atın.

  • Birden çok gönderiyi aynı anda yeniden takip edin — retrack_shipments kullanarak birkaç takip numarası için toplu olarak takibi yeniden tetikleyin.

  • Gönderilerle birlikte siparişleri yönetin — create_order, update_order ve list_orders aracılığıyla siparişler oluşturun, güncelleyin ve listeleyin.

Dokümantasyon

TrackMage MCP Sunucusu - Gönderi Takip API'si ve Lojistik API Entegrasyonu

TrackMage API'sini kullanan, gönderi takip api'si, paket izleme ve lojistik yönetimi için bir Model Bağlam Protokolü (MCP) sunucusu. Dünya çapında 1600'den fazla kargo firmasında takibi destekler.

Özellikler

  • Kargo Desteği: Dünya çapında 1600'den fazla kargo firmasında paketleri takip edin (tam liste)
  • Kaynaklar: Çalışma alanları, gönderiler, siparişler, kargo firmaları, takip durumları
  • Araçlar: Gönderi/sipariş oluşturma, gönderi kontrol noktalarını alma, kargo firması tespiti
  • Kimlik Doğrulama: İstemci kimlik bilgileriyle OAuth

⚠️ Veri Gizliliği Bildirimi

LLM sağlayıcınızla veri paylaşımı: Bu MCP sunucusu, kullandığınız LLM'ye (Claude, ChatGPT, vb.) veri sağlar. Bu, MCP sunucuları için beklenen bir davranış olsa da, takip numaraları, müşteri e-postaları, adresler ve gönderi detayları dahil olmak üzere lojistik verilerini seçtiğiniz LLM sağlayıcısıyla paylaşma konusunda rahat olduğunuzdan emin olun.

En iyi uygulamalar:

  • Gizlilik endişeleriniz varsa yalnızca hassas olmayan veya test verileriyle kullanın
  • LLM sağlayıcınızın veri işleme politikalarını kontrol edin
  • Mümkünse eğitim verisi programlarından çıkmayı değerlendirin
  • Kuruluşunuzun veri politikalarına uygunluğu sağlayın

Ön Koşullar

  • Node.js v18+
  • TrackMage hesabı

Kimlik Bilgilerini Alma

  1. TrackMage adresine kaydolun ve giriş yapın.
  2. Ayarlar > API ANAHTARLARI bölümüne gidin.
  3. Bir Uygulama Adı (örn. "MCP") ve Uygulama URL'si (örn. http://localhost:3000) girin.
  4. Oluştur'a tıklayın ve İstemci Kimliğinizi ve İstemci Sırrınızı kopyalayın.
  5. Kontrol paneli URL'sinden Çalışma Alanı Kimliğinizi not edin.

Kurulum

Seçenek 1: Yerel Kurulum

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

Yapılandırma

.env dosyasını düzenleyin:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

Kullanım

Sunucuyu çalıştırın:

npm start

ve ardından kullanın

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

veya dosya işlemi kullanarak:

{
  "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 Kaynakları

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

MCP Araçları

Gönderi Yönetimi

  • create_shipment: Yeni bir gönderi oluşturun

    • Parametreler: { trackingNumber, originCarrier?, email?, workspaceId? }
    • Döndürür: Oluşturulan gönderi nesnesi

  • update_shipment: Mevcut bir gönderiyi güncelleyin

    • Parametreler: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
    • Döndürür: Güncellenen gönderi nesnesi

  • list_shipments: Çalışma alanındaki gönderileri listeleyin

    • Parametreler: { workspaceId?, page?, itemsPerPage? }
    • Döndürür: Gönderi nesneleri dizisi

  • get_shipment_checkpoints: Bir gönderi için takip kontrol noktalarını alın

    • Parametreler: { shipmentId }
    • Döndürür: Takip kontrol noktası olayları dizisi

  • retrack_shipments: Takip numaralarına göre birden fazla gönderiyi yeniden takip edin

    • Parametreler: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
    • Döndürür: Yeniden takip sonuçları

Sipariş Yönetimi

  • create_order: Yeni bir sipariş oluşturun

    • Parametreler: { orderNumber, email?, workspaceId? }
    • Döndürür: Oluşturulan sipariş nesnesi

  • update_order: Mevcut bir siparişi güncelleyin

    • Parametreler: { orderId, orderNumber?, email?, status? }
    • Döndürür: Güncellenen sipariş nesnesi

  • list_orders: Çalışma alanındaki siparişleri listeleyin

    • Parametreler: { workspaceId?, page?, itemsPerPage? }
    • Döndürür: Sipariş nesneleri dizisi

Kargo Firması Yönetimi

  • list_carriers: Mevcut kargo firmalarını listeleyin

    • Parametreler: { page?, itemsPerPage? }
    • Döndürür: Kodlar ve adlarla birlikte kargo firması nesneleri dizisi

  • detect_carrier: Bir takip numarası için olası kargo firmalarını tespit edin

    • Parametreler: { trackingNumber }
    • Döndürür: Olası kargo firması eşleşmeleri dizisi

Test

npm test