TrackMage MCP Server

TrackMage MCP Server - API ติดตามพัสดุ & การผสานรวม API โลจิสติกส์

เซิร์ฟเวอร์ Model Context Protocol (MCP) สำหรับ API ติดตามพัสดุ การตรวจสอบพัสดุ และการจัดการโลจิสติกส์ โดยใช้ TrackMage API รองรับการติดตามผู้ให้บริการขนส่งมากกว่า 1600 รายทั่วโลก

คุณสมบัติ

• การรองรับผู้ให้บริการขนส่ง: ติดตามพัสดุจากผู้ให้บริการขนส่งมากกว่า 1600 รายทั่วโลก (รายชื่อทั้งหมด)
• ทรัพยากร: พื้นที่ทำงาน, การจัดส่ง, คำสั่งซื้อ, ผู้ให้บริการขนส่ง, สถานะการติดตาม
• เครื่องมือ: สร้างการจัดส่ง/คำสั่งซื้อ, รับจุดตรวจสอบการจัดส่ง, การตรวจจับผู้ให้บริการขนส่ง
• การรับรองความถูกต้อง: OAuth ด้วยข้อมูลประจำตัวของไคลเอนต์

⚠️ ประกาศความเป็นส่วนตัวของข้อมูล

การแชร์ข้อมูลกับผู้ให้บริการ LLM ของคุณ: เซิร์ฟเวอร์ MCP นี้ให้ข้อมูลแก่ LLM ใดก็ตามที่คุณใช้ (Claude, ChatGPT ฯลฯ) แม้ว่านี่จะเป็นพฤติกรรมที่คาดหวังสำหรับเซิร์ฟเวอร์ MCP แต่โปรดตรวจสอบให้แน่ใจว่าคุณสบายใจที่จะแชร์ข้อมูลโลจิสติกส์ รวมถึงหมายเลขติดตาม อีเมลลูกค้า ที่อยู่ และรายละเอียดการจัดส่ง กับผู้ให้บริการ LLM ที่คุณเลือก

แนวทางปฏิบัติที่ดีที่สุด:

• ใช้กับข้อมูลที่ไม่ละเอียดอ่อนหรือข้อมูลทดสอบเท่านั้น หากคุณมีข้อกังวลด้านความเป็นส่วนตัว
• ตรวจสอบนโยบายการจัดการข้อมูลของผู้ให้บริการ LLM ของคุณ
• พิจารณายกเลิกโปรแกรมข้อมูลการฝึกอบรม หากมีให้เลือก
• ตรวจสอบการปฏิบัติตามนโยบายข้อมูลขององค์กรของคุณ

ข้อกำหนดเบื้องต้น

• Node.js v18+
• บัญชี TrackMage

การรับข้อมูลประจำตัว

1. ลงทะเบียนและเข้าสู่ระบบ TrackMage
2. ไปที่ Settings > API KEYS
3. ป้อน App Name (เช่น "MCP") และ App URL (เช่น http://localhost:3000)
4. คลิก Generate และคัดลอก Client ID และ Client Secret ของคุณ
5. จดบันทึก Workspace ID ของคุณจาก URL แดชบอร์ด

การติดตั้ง

ตัวเลือก 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