playwright-wizard-mcp

Playwright — стандарт для end-to-end тестирования веб-приложений. playwright-wizard-mcp — это MCP-сервер, который превращает написание тестов в диалог. Вы описываете сценарий обычными словами, а сервер генерирует готовый код на TypeScript. Он учитывает лучшие практики: правильные селекторы, обработку ожиданий, структуру Page Object. Сервер полезен на всех этапах: от написания первого теста до рефакторинга и отладки сложной цепочки действий. Он берёт на себя рутину и снижает порог входа для новичков. Это инструмент для QA-инженеров и разработчиков, которые хотят ускорить автоматизацию и писать стабильные тесты.

Установка

npx -y playwright-wizard-mcp

Характеристики

Общее

  • СтатусСообщество

Технологии

  • Транспорт
    stdio

Описание

Возможности

  • Генерация тестов по текстовому описанию. Вы говорите, что нужно сделать, сервер пишет код.
  • Создание Page Object классов. Помогает структурировать проект и переиспользовать код.
  • Подбор надёжных селекторов. Вместо div.container сервер использует getByTestId, getByRole, getByText. Это делает тесты устойчивее к изменениям в вёрстке.
  • Автоматическая расстановка ожиданий. Добавляет waitFor, toBeVisible, toBeEnabled, где это необходимо, чтобы тесты не срабатывали раньше времени.
  • Генерация проверок (assertions). Проверяет текст, состояние элементов, URL, атрибуты.
  • Работа с моками API. Подменяет ответы сервера для изолированного тестирования фронтенда.
  • Отладка ошибок. Анализирует код упавшего теста и предлагает конкретные правки.
  • Генерация тестов для разных браузеров. Автоматически адаптирует код для Chromium, Firefox и WebKit.

Как подключить

1. Убедитесь, что Node.js установлен. Выполните в терминале: npx -y playwright-wizard-mcp. После первого запуска команда скачает и установит пакет.

2. Добавьте сервер в конфигурацию вашего MCP-клиента. Для Claude Desktop отредактируйте файл claude_desktop_config.json. Пример конфигурации:

{ "mcpServers": { "playwright-wizard": { "command": "npx", "args": ["-y", "playwright-wizard-mcp"] } } }

Для VS Code используйте расширение MCP (Continue, Cline) и укажите ту же команду в настройках.

3. Закройте и снова откройте клиентское приложение. В списке инструментов появится Playwright Wizard.

Примеры запросов

  • «Сгенерируй тест для страницы логина. Проверь успешную аутентификацию и вывод сообщения об ошибке при неверных данных. Используй Page Object».
  • «Напиши тест, который открывает сайт, находит товар по имени, добавляет его в корзину и переходит к оформлению заказа. Добавь проверки на каждом шаге».
  • «Проанализируй этот HTML-код формы регистрации и создай тест на Playwright, который заполняет все поля валидными данными и отправляет форму. Используй самые надёжные селекторы».
  • «Вот тест, который падает с таймаутом на этапе ожидания попапа. Найди причину и перепиши его, чтобы он работал стабильно в разных браузерах».

Технические детали

Язык: TypeScript

Транспорт: stdio (подходит для локальных задач и CI)

Лицензия: MIT

Совместимость: Claude Desktop, VS Code, Cursor, JetBrains IDE, любые MCP-клиенты.

Поделиться