Openworker E-Commerce MCP Server

Servidor MCP (Model Context Protocol) diseñado para usarse con Openworker para controlar Chrome o Microsoft Edge en la gestión de productos en las principales plataformas de comercio electrónico: Shopee, TikTok Shop y Lazada.

🚀 Objetivo del proyecto (Project Overview)

Este sistema se ha desarrollado para resolver los problemas del control automatizado del navegador de los bots habituales en la página del Seller Center:

1. Inicio de sesión mediante una sesión real: se conecta al Chrome/Edge en el que el usuario ya tiene la sesión iniciada a través del puerto Remote Debugging (9222), sin necesidad de volver a iniciar sesión ni de encontrarse OTP/2FA repetidos.

2. Actualización rápida mediante Internal API Interception: extrae las cookies/tokens de sesión del navegador y envía las órdenes de actualización directamente a través de la API; es rápida, precisa y no depende únicamente de los clics en la UI.

3. Safety Guard & Captcha Pause: comprueba los límites de precio y de stock antes de guardar y se detiene en espera cuando aparece un Captcha para que el usuario pueda desbloquearlo de inmediato.

Related MCP server: camoufox-mcp

👥 Roles y funciones (Team & Development Roles)

• Jules (Google AI Agent): desarrolla el código TypeScript, desarrolla las herramientas de cada categoría (Browser Attach, Session Interceptor, API Client, Safety Guard) y realiza las pruebas unitarias.

• Controller Agent (Cowork / GitHub Controller): controla la estructura del proyecto, revisa el código/PR, diseña las Task Issues, crea los Tag Release y despliega en Openworker.

🛠️ Estructura del proyecto (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

💻 Inicio de Chrome / Edge para la conexión

Antes de empezar, abre Chrome o Microsoft Edge con el comando Remote Debugging:

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"

⚙️ Instalación y uso (Installation & Build)

# ติดตั้ง dependencies
npm install

# Build TypeScript
npm run build

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

📄 Licencia (License)

MIT License - desarrollado por tukimtk-design

🚀 Funcionalidades de la Fase 7

Inicio automático en Windows

Si la conexión CDP falla en Windows, el sistema intentará iniciar Chrome/Edge automáticamente con el puerto Remote Debugging correcto para ofrecer una experiencia fluida con un solo clic.

Mocks E2E de Playwright

Puedes ejecutar los flujos E2E simulados a través de:

npm test

Instalador automático de Openworker

Ejecuta el script de PowerShell para compilar el proyecto y generar la configuración de MCP:

.\scripts\install-openworker-mcp.ps1

🚀 Funcionalidades de la Fase 8

Sincronización de stock multiplataforma

Sincroniza automáticamente el stock y los precios entre Shopee, TikTok Shop y Lazada. El sistema coordina los límites de seguridad y registra las operaciones.

Coincidencia difusa de variantes

El sistema utiliza la similitud de cadenas (distancia de Levenshtein) para emparejar las variantes de producto que tienen nombres diferentes entre plataformas, aprovechando SQLite para almacenar en caché las coincidencias acertadas y recuperarlas de inmediato en el futuro.

🚀 Funcionalidades de la Fase 9 (Enterprise)

Docker y ejecución headless

Despliega 24/7 en la nube usando la imagen oficial de Docker de Playwright con Xvfb:

docker-compose up -d

Autocorrección visual del DOM

Realiza capturas de pantalla del viewport y bounding boxes para que la IA pueda autocorregirse ante superposiciones inesperadas del DOM.

Rotación de proxies

Admite la rotación de proxies para el aislamiento de varias cuentas.