Openworker E-Commerce MCP Server

MCP (Model Context Protocol) Server, entwickelt für die Verwendung mit Openworker, um Chrome oder Microsoft Edge zur Verwaltung von Produkten auf den wichtigsten E-Commerce-Plattformen Shopee, TikTok Shop und Lazada zu steuern.

🚀 Projektübersicht (Project Overview)

Dieses System wurde entwickelt, um die Probleme der automatisierten Browsersteuerung herkömmlicher Bots auf der Seller-Center-Seite zu lösen:

1. Anmeldung über echte Sessions: Verbindung mit Chrome/Edge, bei dem der Benutzer bereits angemeldet ist, über den Remote-Debugging-Port (9222). Keine erneute Anmeldung oder wiederholte OTP/2FA-Abfragen erforderlich.

2. Schnelle Updates durch Internal API Interception: Abrufen von Session-Cookies/-Tokens aus dem Browser und direktes Senden von Update-Befehlen über die API. Schnell, präzise und nicht nur auf UI-Klicks angewiesen.

3. Safety Guard & Captcha Pause: Überprüfung von Preis- und Lagerbestandsgrenzen vor dem Speichern sowie Anhalten bei Captchas, damit der Benutzer sie sofort entsperren kann.

Related MCP server: camoufox-mcp

👥 Rollen und Arbeitsweise (Team & Development Roles)

• Jules (Google AI Agent): Entwicklung von TypeScript-Code, Entwicklung der Tools in den einzelnen Kategorien (Browser Attach, Session Interceptor, API Client, Safety Guard) sowie Durchführung von Unit-Tests.

• Controller Agent (Cowork / GitHub Controller): Kontrolle der Projektstruktur, Code-/PR-Review, Entwurf von Task-Issues, Erstellung von Tag-Releases und Deployment in Openworker.

🛠️ Projektstruktur (Project Structure)

openworker-ecommerce-mcp/
├── src/
│   ├── index.ts                # Entry point หลักของ MCP Server
│   ├── types.ts                # Type Definitions & Schemas
│   ├── services/
│   │   ├── cdp-connection.ts   # ตัวจัดการเชื่อมต่อ Chrome/Edge CDP (Port 9222)
│   │   ├── session-extractor.ts# ตัวดึง Auth Cookies / Bearer Tokens จาก Tab
│   │   └── api-client.ts       # Internal API Wrapper สำหรับ Shopee/TikTok/Lazada
│   └── tools/
│       ├── browser-profile.ts  # Tool: browser_attach_existing
│       ├── ecommerce-search.ts # Tool: ecommerce_product_search
│       ├── ecommerce-update.ts # Tool: ecommerce_update_price_stock
│       └── safety-guard.ts     # Tool: ecommerce_safety_guard
├── docs/
│   ├── ARCHITECTURE.md         # สถาปัตยกรรมและรายละเอียด Tool Contracts
│   └── TASKS.md                # รายการงานสำหรับการพัฒนาราย Phase
├── JULES_PROMPT.md             # ข้อแนะนำการสั่งงาน Jules (Google AI Agent)
├── package.json
└── tsconfig.json

💻 Aktivieren von Chrome / Edge für die Verbindung

Vor der Verwendung öffnen Sie Chrome oder Microsoft Edge mit dem Remote-Debugging-Befehl:

Windows (Chrome):

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\ChromeAutomationProfile"

Windows (Edge):

"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --remote-debugging-port=9222 --user-data-dir="C:\EdgeAutomationProfile"

⚙️ Installation und Verwendung (Installation & Build)

# ติดตั้ง dependencies
npm install

# Build TypeScript
npm run build

# ทดสอบรัน MCP Server
npm start

📄 Lizenz (License)

MIT License - Entwickelt von tukimtk-design

🚀 Phase 7 Features

Auto-Launch on Windows

Wenn die CDP-Verbindung unter Windows fehlschlägt, versucht das System, Chrome/Edge automatisch mit dem korrekten Remote-Debugging-Port zu starten, um ein nahtloses 1-Klick-Erlebnis zu bieten.

Playwright E2E Mocks

Sie können die gemockten E2E-Abläufe wie folgt ausführen:

npm test

Openworker Auto-Installer

Führen Sie das PowerShell-Skript aus, um das Projekt zu erstellen und die MCP-Konfiguration zu generieren:

.\scripts\install-openworker-mcp.ps1

🚀 Phase 8 Features

Multi-Platform Stock Sync

Synchronisiert automatisch Lagerbestände und Preise über Shopee, TikTok Shop und Lazada hinweg. Das System orchestriert Sicherheitsgrenzen und protokolliert Vorgänge.

Fuzzy Variant Matching

Das System verwendet String-Ähnlichkeit (Levenshtein-Distanz), um Produktvarianten abzugleichen, die auf verschiedenen Plattformen unterschiedlich benannt sind, und nutzt SQLite, um erfolgreiche Abgleiche für zukünftige Abrufe zwischenzuspeichern.

🚀 Phase 9 Features (Enterprise)

Docker & Headless Run

24/7 in der Cloud bereitstellen mit dem offiziellen Playwright-Docker-Image mit Xvfb:

docker-compose up -d

Visual DOM Self-Correction

Erfasst Viewport-Screenshots und Bounding-Boxes, damit die KI bei unerwarteten DOM-Overlays selbst korrigieren kann.

Proxy Rotation

Unterstützt rotierende Proxys für die Isolierung mehrerer Konten.