Parcel Pilot MCP

Parcel Pilot MCP verwendet Playwright Chromium, um Ihren persönlichen Browser-Login-Status zu speichern, und stellt die Paketdaten dann über MCP für KI-Clients bereit. Sie können Fragen stellen wie:

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

Es ist für den persönlichen Gebrauch konzipiert und kann lokal auf einem Mac oder auf Ihrem eigenen Linux-Server ausgeführt werden. Es handelt sich nicht um eine offizielle API-Anbindung von Taobao, JD oder Cainiao.

Funktionshighlights

Related MCP server: Parcel MCP Server

Beispielantwort

{
  "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"
    }
  ]
}

Plattformstatus

Die Seiten von E-Commerce-Plattformen ändern sich häufig, daher müssen die Parser entsprechend der tatsächlichen Seite gewartet werden.

Schnellstart

npm install
npm run build

Playwright installiert Chromium während npm install. Falls unter Linux Systemabhängigkeiten fehlen, können Sie diese installieren:

npx playwright install-deps chromium

Kopieren Sie .env.example nach .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

Für den ersten Login unter macOS wird empfohlen, den sichtbaren Browser zu öffnen:

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

Nachdem Sie den QR-Code gescannt und die notwendigen Verifizierungen abgeschlossen haben, synchronisieren und abfragen:

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-Client-Konfiguration

Jeder Client, der MCP stdio unterstützt, kann wie folgt konfiguriert werden:

{
  "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"
      }
    }
  }
}

Erster Login-Prozess

1. Lassen Sie den KI-Client login_taobao, login_jd oder login_cainiao aufrufen.

2. Öffnen Sie den zurückgegebenen screenshotPath, der sich normalerweise unter var/login/ befindet.

3. Scannen Sie den QR-Code mit Ihrem Mobiltelefon, um sich einzuloggen.

4. Schließen Sie Captchas, SMS, Slider oder Risikohinweise manuell ab.

5. Rufen Sie sync_packages auf.

6. Danach können Sie get_my_packages, track_package oder get_delivered_today abfragen.

Wenn der QR-Code-Screenshot zu schnell abläuft oder die Login-Seite Interaktionen erfordert, können Sie einen sichtbaren Browser über noVNC, SSH X-Forwarding oder eine Desktop-Sitzung öffnen:

PACKAGE_ASSISTANT_HEADLESS=false npm run dev

MCP-Tools

Bereitstellung auf einem privaten Linux-Server

Empfohlene Konfiguration:

• Docker und Docker Compose.

• Zugriff nur über SSH.

• MCP wird vom KI-Client auf derselben Maschine über stdio gestartet oder über SSH/VPN genutzt.

• Kein öffentlicher HTTP-Zugang ohne Authentifizierung.

Bereitstellung vom lokalen Rechner:

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

Führen Sie den einmaligen Login und die Synchronisierung auf dem Server durch:

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

Für einen interaktiven Remote-Browser:

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

Dann öffnen:

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

Aufruf des MCP auf dem Server über SSH:

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

Sicherheitsmodell

Bitte behandeln Sie browser-profiles/ wie einen „bereits eingeloggten Browser“ und schützen Sie ihn entsprechend.

• Übertragen Sie keine data/, var/, browser-profiles/, .env oder tmp-login/ Dateien.

• Setzen Sie den MCP-Prozess, noVNC oder temporäre Login-Browser nicht dem öffentlichen Internet aus.

• Nur für die Verwendung mit Ihrem eigenen Konto und auf Maschinen unter Ihrer Kontrolle empfohlen.

• Wer Zugriff auf das Browser-Profil hat, kann möglicherweise Bestellungen, Logistik, Lieferadressen und Kontoseiten einsehen.

• Dieses Projekt umgeht keine Captchas, Slider, SMS-Verifizierungen oder Plattform-Risikokontrollen.

• Es wird empfohlen, Zahlungen ohne Passwort, automatische Abbuchungen und Express-Bestellungen zu deaktivieren, um das Risiko bei einem Missbrauch des Login-Status zu minimieren.

Entwicklung

npm test
npm run build

Übliche lokale Befehle:

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

Roadmap

• Verfeinerung der JD- und Cainiao-Selektoren mit mehr echten Kontoseiten.

• Hinzufügen einer optionalen Anonymisierung für sensible Felder wie Produktnamen und Adressen.

• Hinzufügen einer Gesundheitsdiagnose für Provider bei abgelaufenem Login-Status, Risikoseiten oder leeren Seiten.

• Hinzufügen von Konfigurationsbeispielen für MCP-Clients wie Claude Desktop, Codex usw.

Lizenz

MIT