MCPHIVE

Playwright MCP: Документация

Обновлено:

Подключение

  • npx @playwright/mcp@latest (stdio). Конфиг для клиентов Claude/Cursor/VS Code — в README репозитория.
  • Docker: docker run -i --rm mcr.microsoft.com/playwright/mcp.
  • Отдельный HTTP-сервер: npx @playwright/mcp@latest --port 8931.
  • Флаги: --browser (chromium/firefox/webkit/msedge), --headless, --viewport-size, --device, --isolated, --proxy-server.

Инструменты (базовый набор)

  • browser_navigate, browser_navigate_back, browser_click, browser_type, browser_hover, browser_drag, browser_select_option — навигация и ввод.
  • browser_fill_form — заполнение нескольких полей формы за один вызов.
  • browser_snapshot — снимок accessibility-дерева страницы (главный инструмент «зрения», без пикселей).
  • browser_take_screenshot, browser_pdf_save — визуальный скриншот и экспорт в PDF.
  • browser_console_messages, browser_network_requests, browser_network_request — консоль и сетевые запросы.
  • browser_tabs, browser_file_upload, browser_handle_dialog, browser_wait_for — вкладки, загрузка файлов, диалоги, ожидание условий.
  • browser_evaluate, browser_run_code_unsafe — выполнение JS/Playwright-кода на странице.

Дополнительные наборы (--caps=...)

  • vision — клики по координатам (browser_mouse_click_xy и др.) вместо accessibility-дерева.
  • pdf — сохранение страницы в PDF.
  • storage — работа с cookies, localStorage, sessionStorage, сохранение/восстановление сессии.
  • network — мок сетевых ответов (browser_route), офлайн-режим.
  • devtools — трейсинг, запись видео, аннотации на странице.
  • testing — генерация локаторов и assert'ы видимости/значений элементов.

Сценарий для агента

Проверка своей вёрстки, e2e-прогоны, заполнение форм на сайтах без API, скрейпинг интерактивных страниц.

Ограничения

Сервер бесплатный, но требует локального ресурса: под капотом реальный браузер (Chromium/Firefox/WebKit/Edge), значит нужны CPU/память на машине с MCP-клиентом.