Сервер Patchright Lite MCP

Оптимизированный сервер Model Context Protocol (MCP), который оборачивает Patchright Node.js SDK для предоставления скрытых возможностей автоматизации браузера для моделей ИИ. Этот легкий сервер фокусируется на основных функциях, чтобы упростить использование более простых моделей ИИ.

Что такое Patchright?

Patchright — это необнаруживаемая версия фреймворка тестирования и автоматизации Playwright. Он разработан как замена Playwright, но с расширенными возможностями скрытности, чтобы избежать обнаружения антибот-системами. Patchright исправляет различные методы обнаружения, включая:

• Runtime.enable утечка

• Консоль.включить утечку

• Утечка флагов команд

• Общие точки обнаружения

• Закрытые взаимодействия Shadow Root

Этот сервер MCP представляет собой оболочку для версии Patchright на Node.js, которая делает ее возможности доступными для моделей ИИ через простой стандартизированный протокол.

Related MCP server: Puppeteer-Extra MCP Server

Функции

• Простой интерфейс : сосредоточен на основных функциях с использованием всего 4 основных инструментов.

• Stealth Automation : использует скрытый режим Patchright, чтобы избежать обнаружения.

• Стандарт MCP : реализует протокол контекста модели для легкой интеграции ИИ

• Stdio Transport : использует стандартный ввод/вывод для бесшовной интеграции.

Предпосылки

• Node.js 18+

• npm или пряжа

Установка

1. Клонируйте этот репозиторий:

   git clone https://github.com/yourusername/patchright-lite-mcp-server.git
   cd patchright-lite-mcp-server

2. Установите зависимости:

   npm install

3. Создайте код TypeScript:

   npm run build

Использование

Запустите сервер с помощью:

npm start

Это запустит сервер с транспортом stdio, подготовив его к интеграции с инструментами ИИ, поддерживающими MCP.

Интеграция с моделями ИИ

Клод Десктоп

Добавьте это в файл claude-desktop-config.json :

{
 "mcpServers": {
 "patchright": {
 "command": "node",
 "args": ["path/to/patchright-lite-mcp-server/dist/index.js"]
 }
 }
}

VS Code с GitHub Copilot

Используйте VS Code CLI для добавления сервера MCP:

code --add-mcp '{"name":"patchright","command":"node","args":["path/to/patchright-lite-mcp-server/dist/index.js"]}'

Доступные инструменты

Сервер предоставляет всего 4 основных инструмента:

1. просмотреть

Запускает браузер, переходит по URL-адресу и извлекает содержимое.

Tool: browse
Parameters: {
 "url": "https://example.com",
 "headless": true,
 "waitFor": 1000
}

Возврат:

• Заголовок страницы

• Предварительный просмотр видимого текста

• Идентификатор браузера (для последующих операций)

• Идентификатор страницы (для последующих операций)

• Путь к скриншоту

2. взаимодействовать

Выполняет простое взаимодействие на странице.

Tool: interact
Parameters: {
 "browserId": "browser-id-from-browse",
 "pageId": "page-id-from-browse",
 "action": "click", // can be "click", "fill", or "select"
 "selector": "#submit-button",
 "value": "Hello World" // only needed for fill and select
}

Возврат:

• Результат действия

• Текущий URL-адрес

• Путь к скриншоту

3. извлечение

Извлекает определенный контент с текущей страницы.

Tool: extract
Parameters: {
 "browserId": "browser-id-from-browse",
 "pageId": "page-id-from-browse",
 "type": "text" // can be "text", "html", or "screenshot"
}

Возврат:

• Извлеченный контент на основе запрошенного типа

4. закрыть

Закрывает браузер для освобождения ресурсов.

Tool: close
Parameters: {
 "browserId": "browser-id-from-browse"
}

Пример использования потока

1. Запустите браузер и перейдите на сайт:

   Tool: browse
   Parameters: {
    "url": "https://example.com/login",
    "headless": false
   }

2. Заполните форму входа:

   Tool: interact
   Parameters: {
    "browserId": "browser-id-from-step-1",
    "pageId": "page-id-from-step-1",
    "action": "fill",
    "selector": "#username",
    "value": "user@example.com"
   }

3. Введите пароль:

   Tool: interact
   Parameters: {
    "browserId": "browser-id-from-step-1",
    "pageId": "page-id-from-step-1",
    "action": "fill",
    "selector": "#password",
    "value": "password123"
   }

4. Нажмите кнопку входа:

   Tool: interact
   Parameters: {
    "browserId": "browser-id-from-step-1",
    "pageId": "page-id-from-step-1",
    "action": "click",
    "selector": "#login-button"
   }

5. Извлеките текст для подтверждения входа:

   Tool: extract
   Parameters: {
    "browserId": "browser-id-from-step-1",
    "pageId": "page-id-from-step-1",
    "type": "text"
   }

6. Закройте браузер:

   Tool: close
   Parameters: {
    "browserId": "browser-id-from-step-1"
   }

Соображения безопасности

• Этот сервер предоставляет мощные возможности автоматизации. Используйте его ответственно и этично.

• Избегайте автоматизированных действий, которые могут нарушить условия обслуживания веб-сайтов.

• Помните об ограничениях по скорости и не перегружайте сайты запросами.

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Благодарности

• Patchright-nodejs от Kaliiiiiiiiii-Vinyzu

• Модель контекстного протокола от modelcontextprotocol

Использование Докера

Вы можете запустить этот сервер с помощью Docker:

docker run -it --rm dylangroos/patchright-mcp

Локальная сборка образа Docker

Создайте образ Docker:

docker build -t patchright-mcp .

Запустите контейнер:

docker run -it --rm patchright-mcp

Докер Хаб

Образ автоматически публикуется в Docker Hub, когда изменения объединяются с основной веткой. Вы можете найти последний образ по адресу: dylangroos/patchright-mcp

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• browseB
• closeC
• extractC
• interactC