e2e-runner — Claude Code MCP server: E2E tests and setup
Runs browser-based E2E checks from JSON scenarios and lets an agent help create them. Use it to test web app flows in a real browser.
claude mcp add e2e-runner -- npx -y @matware/e2e-runnerWhat e2e-runner does
e2e-runner performs browser actions such as opening a page, filling fields, clicking controls, checking text, and saving screenshots. A test is an ordered JSON action list, so there is no test code to write. Through MCP, an agent can create a scenario, run it, and report the outcome.
Choose a browser setup: connect Chromium through its debugging port, use Obscura, or run a Docker Chrome pool for parallel tests. Install the npm package, then npx e2e-runner init creates an e2e/ directory with a sample test and config. The Docker pool requires Docker; set the app URL to host.docker.internal so containerized Chrome can reach the host app.
Results include pass or fail status, timing, screenshots, and network errors. They appear in the terminal and in the web dashboard when it is open. For local Chrome, set CHROME_POOL_URL and select the cdp driver.
What it helps with
- Test a web app login flow in a browser
- Check that an expected message appears after an action
- Capture a screenshot at the end of a test
- Run tests in parallel with a Chrome pool
Example prompts for the agent
- Create a browser test for login: open
/login, fill in the form, and check the result. - Check the home page at
/and save a screenshot ashome.png. - Run every test in
e2e/and report the results.
How to install e2e-runner
Platform CLI
claude mcp add e2e-runner -- npx -y @matware/e2e-runnerPlatform CLI
codex mcp add e2e-runner -- npx -y @matware/e2e-runnerConfig file
{
"mcpServers": {
"e2e-runner": {
"command": "npx",
"args": [
"-y",
"@matware/e2e-runner"
]
}
}
}Config file
{
"servers": {
"e2e-runner": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@matware/e2e-runner"
]
}
}
}Platform CLI
gemini mcp add e2e-runner npx -y @matware/e2e-runnerStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about e2e-runner
How do I install e2e-runner in Claude Code?
Run claude mcp add e2e-runner -- npx -y @matware/e2e-runner to add the MCP server.
What does e2e-runner do?
It runs browser tests defined as JSON action sequences. An agent can draft a test, execute it, and report what happened.
Do I need Docker to run tests?
No. You can connect a local Chromium browser through its debugging port or use Obscura. Docker is required for the parallel Chrome pool.
