proship-mcp

무상태 MCP(Model Context Protocol) 서버로서, 어떤 AI 에이전트든 ProShip을 통해 Thailand Post 배송을 생성하고, 라벨을 인쇄하고, 소포를 추적할 수 있게 해줍니다.

• 엔드포인트: POST https://mcp.proship.me/mcp (JSON-RPC 2.0, application/json)

• 문서: 브라우저에서 https://mcp.proship.me/mcp를 열면 — 문서 페이지는 라이브 도구 레지스트리에서 생성됩니다.

• 인증: Authorization: Bearer <ProShip API token>는 변경 없이 api.proship.me에 전달됩니다. 서버 측에는 아무것도 저장되지 않습니다. 새 사용자는 공개 signup 도구를 호출하여 토큰을 받을 수 있습니다.

도구

공개: track_parcel, get_order_statuses, signup. 인증 필요: list_shops, create_order, list_orders, get_order, update_order_status, cancel_order, check_duplicate, print_label.

/mcp의 브라우저 문서 페이지는 항상 최신 상태를 유지하는 공식 도구 참조입니다.

Related MCP server: shipsaving-mcp

실행

npm install
npm start          # listens on PORT (default 3000)
npm test           # node:test suite, upstream fully mocked

환경

배포

Fly.io 앱 proship-mcp (지역 sin):

fly deploy            # add --depot=false if the Depot builder fails

참고

• 주문 ID는 파이프 접미사 형식입니다 (order-xxx|123). GET/PUT/DELETE는 내부적으로 접미사를 제거합니다. print_label은 전체 ID가 필요합니다. 도구 간에는 항상 전체 ID를 전달하세요.

• 무게는 그램 단위입니다. 상태 코드는 태국 파이프라인(get_order_statuses)을 사용합니다. 코드 6은 업스트림에서 "ERROR"로 표시됨에도 불구하고 배송 중을 의미합니다.

• 서버가 유지하는 유일한 상태는 라벨 PDF용 10분 인메모리 캐시이며, 이를 통해 print_label이 URL을 반환할 수 있습니다.