TrackMage MCP Server

resmi

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

GitHub
2

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