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でのローカル実行および、プライベートLinuxサーバーへのDockerデプロイをサポートします。
風評リスクを回避しない	キャプチャ、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"
    }
  ]
}

プラットフォームの状態

プラットフォーム	状態	備考
淘宝	ブラウザログイン状態パーサー実装済み	購入済み注文ページを解析し、「輸送中、本日到着予定」などの注文レベルの物流概要を抽出可能。
京東	ブラウザログイン状態アダプターフレームワーク実装済み	ログインおよびセッション構造は接続済み。実際のページセレクターは個人アカウントで継続検証が必要。
菜鳥	ブラウザログイン状態アダプターフレームワーク実装済み	ログインおよびセッション構造は接続済み。実際のページセレクターは個人アカウントで継続検証が必要。

ECサイトのページは頻繁に変更されるため、パーサーは実際のページに合わせて保守する必要があります。

クイックスタート

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