parcel-mcp

Parcel.app 배송 추적 API를 위한 MCP 서버입니다. Claude(및 기타 MCP 클라이언트)가 Parcel 계정의 택배 배송을 조회하고 추가할 수 있게 해줍니다.

최신 parcellapp-mcp.dxt 다운로드

도구

list_deliveries

Parcel 계정의 배송 목록을 조회합니다. Parcel 서버에서 캐시된 데이터를 반환합니다.

• 요청 제한: 시간당 20회

• 매개변수:

  • filter_mode (선택 사항): "active"(진행 중인 배송만) 또는 "recent"(기본값 — 진행 중 + 최근 완료된 배송)

add_delivery

Parcel 계정에 새 배송을 추가합니다.

• 요청 제한: 일일 20회 (실패한 요청 포함)

• 매개변수:

  • tracking_number (필수): 택배 운송장 번호

  • carrier_code (필수): 내부 Parcel 택배사 코드 — 전체 택배사 목록을 참조하세요. 자리 표시자(placeholder)가 필요한 경우 "pholder"를 사용하세요.

  • description (필수): 배송에 대한 라벨(설명)

  • language (선택 사항): ISO 639-1 두 글자 코드, 예: "en"(기본값), "de"

  • send_push_confirmation (선택 사항): 추가 시 푸시 알림을 받으려면 true로 설정 (기본값 false)

참고: 새로 추가된 배송은 Parcel 서버가 처음 업데이트할 때까지 "데이터 없음(No data available)"으로 표시됩니다.

사전 요구 사항

• Node.js 18 이상 (내장 fetch 사용)

• API 키가 포함된 Parcel 프리미엄 계정 — web.parcelapp.net에서 생성 가능

설정

git clone https://github.com/as-j/parcellapp-mcp.git
cd parcellapp-mcp
npm install
npm run build

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "parcel": {
      "command": "node",
      "args": ["/absolute/path/to/parcellapp-mcp/dist/index.js"],
      "env": {
        "PARCEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

저장 후 Claude Desktop을 재시작하세요.

사용 예시

설정이 완료되면 Claude에게 다음과 같이 물어볼 수 있습니다:

• "현재 배송 중인 택배가 뭐야?"

• "진행 중인 배송 목록을 보여줘"

• "운송장 번호 1Z999AA10123456784, 택배사 UPS, 설명 '새 키보드'로 배송 추가해줘"