de en es ja ko ru zh

Parcel Pilot MCP

Name: Parcel Pilot MCP
Author: jieyangxchen

by jieyangxchen

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

Parcel Pilot MCP는 Playwright Chromium을 사용하여 개인 브라우저 로그인 상태를 저장하고, MCP를 통해 AI 클라이언트에 택배 데이터를 제공합니다. 다음과 같이 질문할 수 있습니다:

查询我所有待收货快递
今天有没有已经签收的包裹？
帮我查一下上周淘宝订单的物流进度

개인용으로 적합하며, Mac 로컬 환경이나 본인의 Linux 서버에서 실행할 수 있습니다. 타오바오, 징둥, 차이냐오의 공식 오픈 API 연동이 아닙니다.

기능 하이라이트

기능	설명
로컬 우선 로그인	QR 코드 로그인은 본인의 Playwright Chromium 프로필 내에서 수행됩니다.
AI 직접 호출 가능	MCP stdio를 통해 `get_my_packages`, `track_package`, `get_delivered_today`를 노출합니다.
다중 플랫폼 통합 모델	타오바오, 징둥, 차이냐오 데이터를 동일한 택배 기록 형식으로 정규화합니다.
로컬 및 서버 지원	macOS 로컬 실행 및 Docker를 통한 개인 Linux 서버 배포를 지원합니다.
보안 정책 우회 안 함	인증 코드, SMS, 슬라이더, 위험 알림 등은 직접 수동으로 완료해야 합니다.

Related MCP server: Parcel MCP Server

응답 예시

{
  "packages": [
    {
      "id": "taobao-1234567890",
      "source": "taobao",
      "title": "USB-C 数据线",
      "status": "in_transit",
      "carrier": "菜鸟",
      "trackingNumber": "YT123456789CN",
      "lastEvent": "运输中预计今天送达",
      "updatedAt": "2026-05-08T09:00:00.000+08:00"
    }
  ]
}

플랫폼 상태

플랫폼	상태	비고
타오바오	브라우저 로그인 상태 파서 구현 완료	구매한 상품 주문 페이지를 파싱하여 '운송 중, 오늘 도착 예정'과 같은 주문별 물류 요약을 추출할 수 있습니다.
징둥	브라우저 로그인 상태 어댑터 프레임워크 완료	로그인 및 세션 구조가 연동되었으며, 실제 페이지 선택자는 개인 계정으로 추가 검증이 필요합니다.
차이냐오	브라우저 로그인 상태 어댑터 프레임워크 완료	로그인 및 세션 구조가 연동되었으며, 실제 페이지 선택자는 개인 계정으로 추가 검증이 필요합니다.

이커머스 사이트 페이지는 자주 변경되므로, 파서는 실제 페이지에 맞춰 유지보수가 필요합니다.

빠른 시작

npm install
npm run build

Playwright는 npm install 시 Chromium을 설치합니다. Linux에서 시스템 의존성이 부족한 경우 다음을 실행하세요:

npx playwright install-deps chromium

.env.example을 .env로 복사합니다:

PACKAGE_ASSISTANT_DATA_DIR=./data
PACKAGE_ASSISTANT_PROFILE_DIR=./browser-profiles
PACKAGE_ASSISTANT_ARTIFACT_DIR=./var
PACKAGE_ASSISTANT_HEADLESS=true
PACKAGE_ASSISTANT_TIMEZONE=Asia/Shanghai

macOS에서 최초 로그인 시 가시 브라우저를 여는 것을 권장합니다:

PACKAGE_ASSISTANT_HEADLESS=false node dist/cli/open-login-browser.js taobao

QR 코드를 스캔하고 필요한 인증을 완료한 후, 동기화 및 조회합니다:

node dist/cli/call-tool.js sync_packages '{"source":"taobao"}'
node dist/cli/call-tool.js get_my_packages
node dist/cli/call-tool.js track_package '{"packageId":"taobao-ORDER_ID"}'

MCP 클라이언트 설정

MCP stdio를 지원하는 모든 클라이언트는 다음과 같이 설정할 수 있습니다:

{
  "mcpServers": {
    "parcel-pilot": {
      "command": "node",
      "args": ["/absolute/path/parcel-pilot-mcp/dist/server.js"],
      "env": {
        "PACKAGE_ASSISTANT_DATA_DIR": "/absolute/path/parcel-pilot-mcp/data",
        "PACKAGE_ASSISTANT_PROFILE_DIR": "/absolute/path/parcel-pilot-mcp/browser-profiles",
        "PACKAGE_ASSISTANT_ARTIFACT_DIR": "/absolute/path/parcel-pilot-mcp/var",
        "PACKAGE_ASSISTANT_HEADLESS": "true",
        "PACKAGE_ASSISTANT_TIMEZONE": "Asia/Shanghai"
      }
    }
  }
}

최초 로그인 절차

AI 클라이언트가 login_taobao, login_jd 또는 login_cainiao를 호출하도록 합니다.
반환된 screenshotPath(보통 var/login/ 아래)를 엽니다.
휴대폰으로 QR 코드를 스캔하여 로그인합니다.
인증 코드, SMS, 슬라이더 또는 보안 알림을 수동으로 완료합니다.
sync_packages를 호출합니다.
이후 get_my_packages, track_package 또는 get_delivered_today를 질문할 수 있습니다.

QR 코드 스크린샷이 너무 빨리 만료되거나 로그인 페이지에서 상호작용이 필요한 경우, noVNC, SSH X forwarding 또는 데스크톱 세션을 통해 가시 브라우저를 열 수 있습니다:

PACKAGE_ASSISTANT_HEADLESS=false npm run dev

MCP 도구

도구	용도
`login_taobao`	타오바오 로그인 절차를 열거나 새로고침하고, 로그인 스크린샷 등의 결과물을 반환합니다.
`login_jd`	징둥 로그인 절차를 열거나 새로고침하고, 로그인 스크린샷 등의 결과물을 반환합니다.
`login_cainiao`	차이냐오 로그인 절차를 열거나 새로고침하고, 로그인 스크린샷 등의 결과물을 반환합니다.
`sync_packages`	단일 플랫폼 또는 설정된 모든 플랫폼에서 택배 데이터를 동기화합니다.
`get_my_packages`	정규화된 택배 목록을 조회하며, 수령 대기 또는 수령 완료 상태로 필터링할 수 있습니다.
`track_package`	package id를 기준으로 특정 택배의 상세 정보를 조회합니다.
`get_delivered_today`	설정된 시간대 기준으로 오늘 수령 완료된 택배를 조회합니다.

개인 Linux 서버 배포

권장 형태:

Docker 및 Docker Compose 사용.
SSH를 통해서만 접근.
MCP는 동일한 머신의 AI 클라이언트가 stdio를 통해 실행하거나, SSH/VPN을 통해 사용.
인증되지 않은 공개 HTTP 엔드포인트는 제공하지 않음.

로컬에서 배포:

./scripts/aliyun-deploy.sh user@your-server:/opt/parcel-pilot-mcp

서버에서 일회성 로그인 및 동기화 실행:

cd /opt/parcel-pilot-mcp
docker compose run --rm -T package-assistant node dist/cli/call-tool.js login_taobao
docker compose run --rm -T package-assistant node dist/cli/call-tool.js login_jd
docker compose run --rm -T package-assistant node dist/cli/call-tool.js login_cainiao
docker compose run --rm -T package-assistant node dist/cli/call-tool.js sync_packages

대화형 원격 브라우저가 필요한 경우:

cd /opt/parcel-pilot-mcp
docker compose run --rm --service-ports package-assistant ./scripts/remote-browser.sh taobao
ssh -N -L 6080:127.0.0.1:6080 user@your-server

그 후 다음을 엽니다:

http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale

SSH를 통해 서버의 MCP 호출:

{
  "mcpServers": {
    "parcel-pilot": {
      "command": "ssh",
      "args": [
        "user@your-server",
        "cd /opt/parcel-pilot-mcp && docker compose run --rm -T package-assistant"
      ]
    }
  }
}

보안 모델

browser-profiles/를 '이미 로그인된 브라우저'로 간주하고 보호하십시오.

data/, var/, browser-profiles/, .env 또는 tmp-login/을 커밋하지 마십시오.
MCP 프로세스, noVNC 또는 임시 로그인 브라우저를 공용 네트워크에 노출하지 마십시오.
본인의 계정과 본인이 제어하는 머신에서만 사용하는 것을 권장합니다.
브라우저 프로필을 탈취한 사람은 주문, 물류, 배송지 및 계정 페이지를 볼 수 있습니다.
본 프로젝트는 인증 코드, 슬라이더, SMS 인증 또는 플랫폼 보안 정책을 우회하지 않습니다.
소액 결제 면제, 자동 결제, 간편 주문 등 낮은 마찰력의 결제/주문 기능을 비활성화하여 로그인 상태가 악용될 경우의 위험을 줄이는 것을 권장합니다.

개발

npm test
npm run build

자주 사용하는 로컬 명령어:

npm run call-tool -- get_my_packages
npm run call-tool -- sync_packages '{"source":"taobao"}'

로드맵

더 많은 실제 계정 페이지를 사용하여 징둥 및 차이냐오 선택자 개선.
상품명, 주소 등 민감 필드에 대한 선택적 마스킹 추가.
로그인 상태 만료, 보안 페이지, 빈 페이지 등 제공자 상태 진단 기능 추가.
Claude Desktop, Codex 등 MCP 클라이언트 설정 예시 추가.

License

MIT

This server cannot be deployed

Give agents eyes on the webHosted screenshot MCP. Send a URL, get a pixel-perfect image. $0.002 per grab. Works with Claude, Cursor, and Codex.grabbit.liveAd

Maintenance

ActivityInactive

ResponsivenessSlow

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

Tracking & Returns A
com.aftership.mcp
Track packages across 1,300+ global carriers with real-time status and AI-powered delivery dates.
E-commerce & Retail Search App Automation
22
Zhiyong Parcel Tracking
dev.zhiyong
General parcel tracking; currently supports UniUni, with more carriers planned.
11
Trakow Order TrackingOAuth
com.trackordernow
Real-time order tracking for Shopify merchants: look up, list, and refresh shipments.
E-commerce & Retail Customer Support
2
Ship24 Tracking A
com.ship24
Track parcels across 2,500+ carriers and 3PLs: live delivery status, event history, carrier lookup.
E-commerce & Retail Travel & Transportation
122

Related MCP Servers

SF Express MCP Server
Travel & Transportation E-commerce & Retail
100kgforest
A
license
Not graded
quality
D
maintenance
Enables integration with SF Express shipping and logistics APIs for order management, shipment tracking, route queries, and logistics services through natural language interactions.
Updated a year ago (2025-08-04 06:56 UTC)
MIT
Parcel MCP Server
Search E-commerce & Retail
NOVA-3951
F
license
Not graded
quality
B
maintenance
Enables AI assistants to track and manage deliveries by interacting with the Parcel delivery tracking API. Users can add new shipments, retrieve active delivery statuses, and look up carrier information through natural language.
Updated 2 months ago (2026-08-17 23:33 UTC)
2
-
Kuaidi100 MCP Server
Search E-commerce & Retail Travel & Transportation
kuaidi100-api
A
license
Not graded
quality
C
maintenance
Integrates Kuaidi100 logistics services to provide real-time package tracking, delivery time estimations, and shipping cost calculations. It enables users to query express delivery information directly through an MCP-compatible interface.
Updated 9 months ago (2025-12-30 10:24 UTC)
14
Apache 2.0
mcp-logistics-tracker
Travel & Transportation Search
k3-yamada
A
license
A
quality
D
maintenance
MCP server for tracking Japanese logistics carriers (Yamato, Sagawa, Japan Post) via mock or AfterShip adapter. Enables AI agents to query shipment status and history in natural language.
Updated 3 months ago (2026-07-08 14:03 UTC)
3
MIT