Сервер Patchright Lite MCP
Оптимизированный сервер Model Context Protocol (MCP), который оборачивает Patchright Node.js SDK для предоставления скрытых возможностей автоматизации браузера для моделей ИИ. Этот легкий сервер фокусируется на основных функциях, чтобы упростить использование более простых моделей ИИ.
Что такое Patchright?
Patchright — это необнаруживаемая версия фреймворка тестирования и автоматизации Playwright. Он разработан как замена Playwright, но с расширенными возможностями скрытности, чтобы избежать обнаружения антибот-системами. Patchright исправляет различные методы обнаружения, включая:
- Runtime.enable утечка
- Консоль.включить утечку
- Утечка флагов команд
- Общие точки обнаружения
- Закрытые взаимодействия Shadow Root
Этот сервер MCP представляет собой оболочку для версии Patchright на Node.js, которая делает ее возможности доступными для моделей ИИ через простой стандартизированный протокол.
Функции
- Простой интерфейс : сосредоточен на основных функциях с использованием всего 4 основных инструментов.
- Stealth Automation : использует скрытый режим Patchright, чтобы избежать обнаружения.
- Стандарт MCP : реализует протокол контекста модели для легкой интеграции ИИ
- Stdio Transport : использует стандартный ввод/вывод для бесшовной интеграции.
Предпосылки
Установка
- Клонируйте этот репозиторий:
git clone https://github.com/yourusername/patchright-lite-mcp-server.git
cd patchright-lite-mcp-server
- Установите зависимости:
- Создайте код TypeScript:
Использование
Запустите сервер с помощью:
Это запустит сервер с транспортом 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"
}
Пример использования потока
- Запустите браузер и перейдите на сайт:
Tool: browse
Parameters: {
"url": "https://example.com/login",
"headless": false
}
- Заполните форму входа:
Tool: interact
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"action": "fill",
"selector": "#username",
"value": "user@example.com"
}
- Введите пароль:
Tool: interact
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"action": "fill",
"selector": "#password",
"value": "password123"
}
- Нажмите кнопку входа:
Tool: interact
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"action": "click",
"selector": "#login-button"
}
- Извлеките текст для подтверждения входа:
Tool: extract
Parameters: {
"browserId": "browser-id-from-step-1",
"pageId": "page-id-from-step-1",
"type": "text"
}
- Закройте браузер:
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