Openworker E-Commerce MCP Server

MCP (Model Context Protocol) Server designed for use with Openworker to control Chrome or Microsoft Edge for managing products on major E-Commerce platforms, namely Shopee, TikTok Shop, and Lazada.

🚀 Project Overview

This system was developed to solve the problems of automated browser control by typical bots on Seller Center pages:

1. Login via Real Session: Connects to a Chrome/Edge instance where the user is already logged in via Remote Debugging Port (9222), no need to log in again or deal with repeated OTP/2FA.

2. Fast Updates via Internal API Interception: Retrieves Session Cookies/Tokens from the browser and sends update commands directly through the API. Fast and accurate, without relying solely on UI clicks.

3. Safety Guard & Captcha Pause: Validates price and stock bounds before saving, and pauses when a Captcha is encountered so the user can unlock it immediately.

Related MCP server: camoufox-mcp

👥 Team & Development Roles

• Jules (Google AI Agent): Develops TypeScript code, develops tools for each category (Browser Attach, Session Interceptor, API Client, Safety Guard), and performs Unit Tests.

• Controller Agent (Cowork / GitHub Controller): Controls the project structure, reviews Code/PR, designs Task Issues, manages Tag Releases, and deploys to Openworker.

🛠️ 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

💻 Launching Chrome / Edge for Connection

Before getting started, launch Chrome or Microsoft Edge with the Remote Debugging command:

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 & Build

# ติดตั้ง dependencies
npm install

# Build TypeScript
npm run build

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

📄 License

MIT License - Developed by tukimtk-design

🚀 Phase 7 Features

Auto-Launch on Windows

If the CDP connection fails on Windows, the system will attempt to automatically launch Chrome/Edge with the correct remote debugging port to provide a seamless 1-click experience.

Playwright E2E Mocks

You can run the mocked E2E flows via:

npm test

Openworker Auto-Installer

Run the PowerShell script to build the project and generate the MCP config:

.\scripts\install-openworker-mcp.ps1

🚀 Phase 8 Features

Multi-Platform Stock Sync

Automatically synchronize stock and prices across Shopee, TikTok Shop, and Lazada. The system orchestrates safety bounds and logs operations.

Fuzzy Variant Matching

The system uses string similarity (Levenshtein Distance) to match product variants that are named differently across platforms, leveraging SQLite to cache successful matches for immediate future retrievals.

🚀 Phase 9 Features (Enterprise)

Docker & Headless Run

Deploy 24/7 on the cloud using the official Playwright Docker image with Xvfb:

docker-compose up -d

Visual DOM Self-Correction

Captures viewport screenshots and bounding boxes to allow AI to self-correct during unexpected DOM overlays.

Proxy Rotation

Supports rotating proxies for multi-account isolation.