TrackMage MCP Server

공식

TrackMage API를 통한 배송 추적 API 및 물류 관리 기능

GitHub
2

문서

TrackMage MCP 서버 - 배송 추적 API 및 물류 API 통합

TrackMage API를 사용한 배송 추적 API, 패키지 모니터링 및 물류 관리를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 전 세계 1600개 이상의 운송업체 추적을 지원합니다.

기능

  • 운송업체 지원: 전 세계 1600개 이상의 운송업체를 통해 패키지 추적 (전체 목록)
  • 리소스: 워크스페이스, 배송, 주문, 운송업체, 추적 상태
  • 도구: 배송/주문 생성, 배송 체크포인트 조회, 운송업체 감지
  • 인증: 클라이언트 자격 증명을 사용한 OAuth

⚠️ 데이터 개인정보 보호 고지

LLM 제공업체와의 데이터 공유: 이 MCP 서버는 사용 중인 LLM(Claude, ChatGPT 등)에 데이터를 제공합니다. 이는 MCP 서버의 예상된 동작이지만, 추적 번호, 고객 이메일, 주소 및 배송 세부 정보를 포함한 물류 데이터를 선택한 LLM 제공업체와 공유하는 것에 대해 동의하는지 확인하시기 바랍니다.

모범 사례:

  • 개인정보 보호 우려가 있는 경우 민감하지 않은 데이터나 테스트 데이터에만 사용하십시오.
  • LLM 제공업체의 데이터 처리 정책을 확인하십시오.
  • 가능한 경우 학습 데이터 프로그램을 거부하는 것을 고려하십시오.
  • 조직의 데이터 정책을 준수하는지 확인하십시오.

사전 요구 사항

  • Node.js v18 이상
  • TrackMage 계정

자격 증명 얻기

  1. TrackMage에 등록하고 로그인합니다.
  2. 설정 > API 키로 이동합니다.
  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