Playwright MCP Server 🎭
Playwright MCP Server — это сервер, реализующий протокол Model Context Protocol (MCP) для автоматизации браузера с помощью Playwright. Он позволяет языковым моделям (LLM) взаимодействовать с веб-страницами: делать скриншоты, выполнять JavaScript, нажимать кнопки, заполнять формы и вообще управлять браузером в реальном окружении.
🔗 Полезные ссылки:
Установка
Сервер можно установить и запустить тремя способами:
1. Через npm (глобально)
npm install -g @executeautomation/playwright-mcp-server
2. Через mcp-get
npx @michaellatman/mcp-get@latest install @executeautomation/playwright-mcp-server
3. Через Smithery (для Claude Desktop)
Автоматическая установка для Claude Desktop:
npx -y @smithery/cli install @executeautomation/playwright-mcp-server --client claude
Конфигурация для Claude Desktop
Добавьте следующий блок в конфигурационный файл Claude Desktop (обычно claude_desktop_config.json):
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["-y", "@executeautomation/playwright-mcp-server"]
}
}
}
После этого Claude сможет использовать браузерные возможности сервера.
Тестирование
Проект использует Jest для тестов. Тесты находятся в директории src/__tests__.
Запуск тестов
# Запуск с покрытием кода
node run-tests.cjs
# Запуск без покрытия
npm test
# Запуск с покрытием через npm
npm run test:coverage
# Запуск тем же скриптом, что и node run-tests.cjs
npm run test:custom
Отчёт о покрытии будет сгенерирован в папке coverage.
Возможности (кратко)
- Открытие страниц и навигация.
- Скриншоты любой области экрана.
- Выполнение JavaScript в контексте страницы.
- Клик, ввод текста, выбор элементов — полная автоматизация действий пользователя.
- Работа с iframe, вкладками, cookie и localStorage.
Важно: для работы требуется Node.js версии 16 или выше и установленный Playwright (npx playwright install chromium). Сервер запускает именно Chromium, так что убедитесь, что среда это поддерживает.
Предупреждения
- Сервер не предназначен для развёртывания в production как публичный API — это инструмент для интеграции LLM с браузером.
- При работе с чувствительными данными (логины, токены) будьте осторожны: LLM может выполнить произвольный JavaScript на странице.
- Используйте только с доверенными MCP-клиентами.
Этот README — пересказ оригинальной документации, адаптированный для русскоязычных разработчиков.
Комментарии
Комментариев пока нет. Будьте первым.