Сервер 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: MCP Browser 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

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

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

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

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

Клод Десктоп

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

VS Code с GitHub Copilot

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

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

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

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

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

Возврат:

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

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

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

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

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

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

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

Возврат:

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

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

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

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

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

Возврат:

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

4. закрыть

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

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

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

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

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

Докер Хаб

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