# Vibe Test — Browser Testing Agent

An MCP server that equips coding editors with 14 Playwright tools, extracts routes directly from your project files, and spots UI regressions between runs without extra model calls.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: AishwaryShrivastav
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AishwaryShrivastav/vibe-testing
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/vibe-test-browser-testing-agent

## What it does

The server equips AI editors with 14 Playwright actions designed for browser automation. Instead of operating blindly, it parses local application files to identify authentic endpoints, form selectors, and handlers. You avoid drafting static test scripts by hand.

Test runs write snapshots to `.vibe/run-snapshot.json` and keep track of application URLs in `.vibe/route-manifest.json`. Comparing snapshots alerts the agent to fresh regressions, repaired pages, or route alterations after every commit. Pass and fail decisions rely on deterministic checks like URL switches, toaster popups, and failed network calls, avoiding extra token costs.

Running this MCP server requires Node.js 20 or newer, alongside the Playwright Chromium build installed via setup.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add vibe-testing -- npx -y vibe-testing
```

### Codex

**Platform CLI**
```bash
codex mcp add vibe-test-browser-testing-agent -- npx -y vibe-testing
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vibe-test-browser-testing-agent": {
            "command": "npx",
            "args": [
                "-y",
                "vibe-testing"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vibe-test-browser-testing-agent": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "vibe-testing"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add vibe-test-browser-testing-agent npx -y vibe-testing
```

## When to use it
- run automated browser interactions through 14 Playwright tools
- detect regressions and fixed pages across consecutive testing runs
- extract real routes and input selectors from repository source files
- generate visual HTML inspection reports with step-by-step screenshots

## Example prompts
- Scan this codebase and test the login flow on http://localhost:3000.
- Check what broke in the checkout sequence after the latest commit.
- Explore the admin routes and generate an HTML report with screenshots.

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 9946
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11912
- [mockserver](https://affpapa.org/en/nevibecode/mcp/mockserver.md) — MCP server · ★ 4996

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md