Openworker E-Commerce MCP Server

MCP-сервер (Model Context Protocol), спроектирован для работы с Openworker для управления Chrome и Microsoft Edge для администрирования товаров на основных E-Commerce платформах: Shopee, TikTok Shop и Lazada.

🚀 Цель проекта (Project Overview)

Система создана для решения проблем автоматического управления браузером, с которыми сталкиваются обычные боты на страницах Seller Center:

1. Вход через реальную сессию: подключение к Chrome/Edge, в котором пользователь уже выполнил вход, через Remote Debugging Port (9222) — не нужно входить заново или повторно проходить OTP/2FA.

2. Быстрые обновления через Internal API Interception: из браузера получаются Session Cookies/Tokens, а команды обновления отправляются напрямую через API — быстро, точно и без опоры только на клики в UI.

3. Safety Guard & Captcha Pause: перед Save проверяются границы цены и остатков, а при появлении Captcha система ставится на паузу, чтобы пользователь мог быстро снять блокировку.

Related MCP server: camoufox-mcp

👥 Роли и обязанности (Team & Development Roles)

• Jules (Google AI Agent): разрабатывает код на TypeScript, создаёт инструменты для каждой из категорий (Browser Attach, Session Interceptor, API Client и Safety guard), пишет unit-тесты.

• Controller Agent (Cowork / GitHub Controller): управляет структурой проекта, ревьюит код/PR, создаёт Task Issues, готовит Tag Release и выполняет Deploy в 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

💻 Запуск Chrome / Edge для подключения

Перед началом работы откройте Chrome или Microsoft Edge в режиме 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"

⚙️ Установка и сборка (Installation & Build)

# ติดตั้ง dependencies
npm install

# Build TypeScript
npm run build

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

📄 Лицензия (License)

MIT License — разработчик tukimtk-design

🚀 Возможности Phase 7

Автозапуск в Windows

Если подключение CDP в Windows не срабатывает, система автоматически попробует запустить Chrome/Edge с корректным port для Remote Debugging, чтобы обеспечить бесшовный запуск в один клик.

Playwright E2E-моки

Вы можете запускать моки E2E-сценариев с помощью:

npm test

Изменение Автоустановщик Openworker

Запустите PowerShell-скрипт, чтобы собрать проект и сгенерировать MCP-конфигурацию:

.\scripts\install-openworker-mcp.ps1

🚀 Возможности Phase 8

Синхронизация остатков между платформами

Автоматически синхронизирует остатки и цены между Shopee, TikTok Shop и Lazada. Система координирует безопасность и запишивает операции в журнала.

Нечёткое сопоставление вариантов

Система использует строковое сходство (Levenshtein Distance), чтобы сопоставлять варианты товаров, названные на платформах по-разному; SQLite кэширует успешные сопоставления для мгновенного повторного использования.

🚀 Возможности Phase 9 (Enterprise)

Docker и Headless-запуск

Разворачивайте проект в облаке 24/7 с официальным Docker образом Playwright и Xvfb:

docker-compose up -d

Визуальная самокоррекция DOM

Создаёт скрины viewport и bounding boxes, чтобы ИИ мог автоматически исправляться при неожиданных DOM-переселениях.

Ротация прокси

Поддерживает вращение прокси для изоляции нескольких аккаунтов.