TrackMage

TrackMage MCP सर्वर - शिपमेंट ट्रैकिंग API और लॉजिस्टिक्स API एकीकरण

एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर, जो शिपमेंट ट्रैकिंग API, पैकेज निगरानी और लॉजिस्टिक्स प्रबंधन के लिए TrackMage API का उपयोग करता है। दुनिया भर में 1600+ वाहकों पर ट्रैकिंग का समर्थन करता है।

विशेषताएँ

• वाहक समर्थन: दुनिया भर में 1600+ वाहकों पर पैकेज ट्रैक करें (पूरी सूची)
• संसाधन: कार्यस्थान, शिपमेंट, ऑर्डर, वाहक, ट्रैकिंग स्थितियाँ
• उपकरण: शिपमेंट/ऑर्डर बनाएँ, शिपमेंट चेकपॉइंट प्राप्त करें, वाहक पहचान
• प्रमाणीकरण: क्लाइंट क्रेडेंशियल्स के साथ OAuth

⚠️ डेटा गोपनीयता सूचना

आपके LLM प्रदाता के साथ डेटा साझाकरण: यह MCP सर्वर आप जिस भी LLM (Claude, ChatGPT, आदि) का उपयोग कर रहे हैं, उसे डेटा प्रदान करता है। हालाँकि MCP सर्वरों के लिए यह अपेक्षित व्यवहार है, कृपया सुनिश्चित करें कि आप अपने चुने हुए LLM प्रदाता के साथ ट्रैकिंग नंबर, ग्राहक ईमेल, पते और शिपमेंट विवरण सहित लॉजिस्टिक्स डेटा साझा करने में सहज हैं।

सर्वोत्तम अभ्यास:

• यदि आपको गोपनीयता संबंधी चिंताएँ हैं तो केवल गैर-संवेदनशील या परीक्षण डेटा के साथ उपयोग करें
• अपने LLM प्रदाता की डेटा हैंडलिंग नीतियों की जाँच करें
• यदि उपलब्ध हो तो प्रशिक्षण डेटा कार्यक्रमों से ऑप्ट आउट करने पर विचार करें
• अपने संगठन की डेटा नीतियों का अनुपालन सुनिश्चित करें

पूर्वापेक्षाएँ

• Node.js v18+
• TrackMage खाता

क्रेडेंशियल्स प्राप्त करना

1. TrackMage पर पंजीकरण करें और लॉग इन करें।
2. सेटिंग्स > API KEYS पर जाएँ।
3. एक ऐप का नाम (जैसे, "MCP") और ऐप URL (जैसे, http://localhost:3000) दर्ज करें।
4. जनरेट करें पर क्लिक करें और अपनी क्लाइंट ID और क्लाइंट सीक्रेट कॉपी करें।
5. डैशबोर्ड URL से अपनी कार्यस्थान ID नोट करें।

स्थापना

विकल्प 1: स्थानीय सेटअप

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

कॉन्फ़िगरेशन

.env संपादित करें:

TRACKMAGE_CLIENT_ID=your_client_id_here
TRACKMAGE_CLIENT_SECRET=your_client_secret_here
TRACKMAGE_WORKSPACE_ID=your_workspace_id_here

उपयोग

सर्वर चलाएँ:

npm start

और फिर उपयोग करें

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

या फ़ाइल प्रक्रिया का उपयोग करके:

{
  "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 संसाधन

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

MCP उपकरण

शिपमेंट प्रबंधन

• create_shipment: एक नया शिपमेंट बनाएँ

  • पैरामीटर: { trackingNumber, originCarrier?, email?, workspaceId? }
  • लौटाता है: निर्मित शिपमेंट ऑब्जेक्ट

• update_shipment: मौजूदा शिपमेंट अपडेट करें

  • पैरामीटर: { shipmentId, trackingNumber?, originCarrier?, email?, status? }
  • लौटाता है: अपडेटेड शिपमेंट ऑब्जेक्ट

• list_shipments: कार्यस्थान से शिपमेंट सूचीबद्ध करें

  • पैरामीटर: { workspaceId?, page?, itemsPerPage? }
  • लौटाता है: शिपमेंट ऑब्जेक्ट की सरणी

• get_shipment_checkpoints: शिपमेंट के लिए ट्रैकिंग चेकपॉइंट प्राप्त करें

  • पैरामीटर: { shipmentId }
  • लौटाता है: ट्रैकिंग चेकपॉइंट घटनाओं की सरणी

• retrack_shipments: ट्रैकिंग नंबरों द्वारा एकाधिक शिपमेंट को पुनः ट्रैक करें

  • पैरामीटर: { trackingNumbers: [{ number, originCarrier? }], workspaceId? }
  • लौटाता है: पुनः ट्रैकिंग परिणाम

ऑर्डर प्रबंधन

• create_order: एक नया ऑर्डर बनाएँ

  • पैरामीटर: { orderNumber, email?, workspaceId? }
  • लौटाता है: निर्मित ऑर्डर ऑब्जेक्ट

• update_order: मौजूदा ऑर्डर अपडेट करें

  • पैरामीटर: { orderId, orderNumber?, email?, status? }
  • लौटाता है: अपडेटेड ऑर्डर ऑब्जेक्ट

• list_orders: कार्यस्थान से ऑर्डर सूचीबद्ध करें

  • पैरामीटर: { workspaceId?, page?, itemsPerPage? }
  • लौटाता है: ऑर्डर ऑब्जेक्ट की सरणी

वाहक प्रबंधन

• list_carriers: उपलब्ध वाहकों की सूची बनाएँ

  • पैरामीटर: { page?, itemsPerPage? }
  • लौटाता है: कोड और नामों के साथ वाहक ऑब्जेक्ट की सरणी

• detect_carrier: ट्रैकिंग नंबर के लिए संभावित वाहकों का पता लगाएँ

  • पैरामीटर: { trackingNumber }
  • लौटाता है: संभावित वाहक मिलानों की सरणी

परीक्षण

npm test