e2e-runner — MCP-сервер для Claude Code: E2E-тесты и установка
Запускает E2E-тесты веб-приложения по сценариям в JSON и помогает создавать их через агента. Подойдёт для проверки пользовательских потоков в браузере.
claude mcp add e2e-runner -- npx -y @matware/e2e-runnerЧто делает e2e-runner
e2e-runner выполняет действия в браузере: открывает страницу, вводит текст, нажимает кнопки, проверяет содержимое и сохраняет скриншоты. Сценарий — упорядоченный список действий в JSON; писать тестовый код не требуется. Через MCP агент может создать тест, запустить его и сообщить результат.
Браузер можно подключить через Chrome с портом отладки, использовать Obscura или запустить пул Chrome в Docker для параллельных тестов. Пакет устанавливается через npm, а npx e2e-runner init создаёт каталог e2e/ с примером теста и конфигурацией. Для Docker-пула нужен Docker; приложению задают адрес host.docker.internal, иначе браузер в контейнере не попадёт на localhost хоста.
Результаты включают статус теста, время выполнения, скриншоты и сетевые ошибки; они выводятся в терминал и, если открыт, веб-дашборд. Для локального Chrome достаточно указать его адрес в CHROME_POOL_URL и выбрать драйвер cdp.
Какие задачи решает
- Проверить вход в веб-приложение по шагам
- Убедиться, что после действия отображается нужный текст
- Сохранить скриншот страницы после прохождения сценария
- Запустить несколько тестов параллельно через пул Chrome
Примеры запросов агенту
- Создай E2E-тест для входа: открой
/login, заполни форму и проверь результат. - Проверь главную страницу: открой
/и сохрани скриншотhome.png. - Запусти все тесты из
e2e/и покажи результаты.
Как установить e2e-runner
Командой платформы
claude mcp add e2e-runner -- npx -y @matware/e2e-runnerКомандой платформы
codex mcp add e2e-runner -- npx -y @matware/e2e-runnerФайл настроек
{
"mcpServers": {
"e2e-runner": {
"command": "npx",
"args": [
"-y",
"@matware/e2e-runner"
]
}
}
}Файл настроек
{
"servers": {
"e2e-runner": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@matware/e2e-runner"
]
}
}
}Командой платформы
gemini mcp add e2e-runner npx -y @matware/e2e-runnerПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о e2e-runner
Как установить e2e-runner в Claude Code?
Выполните claude mcp add e2e-runner -- npx -y @matware/e2e-runner. Эта команда добавляет MCP-сервер.
Что делает e2e-runner?
Он запускает браузерные E2E-сценарии, заданные в JSON. Агент может составить сценарий, выполнить его и сообщить результат.
Нужен ли Docker для запуска тестов?
Нет, можно подключить локальный Chromium через порт отладки или использовать Obscura. Docker нужен для параллельного пула Chrome.
