Vibetest Use

Vibetest_GIF.mp4

An MCP server that launches multiple Browser-Use agents to test a vibe-coded website for UI bugs, broken links, accessibility issues, and other technical problems.

Perfect for testing both live websites and localhost development sites.

Vibecode and vibetest until your website works.

Quick Start

# Install dependencies
uv venv
source .venv/bin/activate
uv pip install -e .

1) Claude Code

# Add MCP server via CLI
claude mcp add vibetest /full/path/to/vibetest-use/.venv/bin/vibetest-mcp -e GOOGLE_API_KEY="your_api_key"

# Test in Claude Code
> claude

> /mcp 
  ⎿  MCP Server Status

     • vibetest: connected

2) Cursor

Install via MCP Settings UI:
- Open Cursor Settings
- Click on "MCP" in the left sidebar
- Click "Add Server" or the "+" button
- Manually edit config:

{
  "mcpServers": {
    "vibetest": {
      "command": "/full/path/to/vibetest-use/.venv/bin/vibetest-mcp",
      "env": {
        "GOOGLE_API_KEY": "your_api_key"
      }
    }
  }
}

Basic Prompts

> Vibetest my website with 5 agents: browser-use.com
> Run vibetest on localhost:3000
> Run a headless vibetest on localhost:8080 with 10 agents

Parameters You Can Specify

URL: Any website (https://example.com, localhost:3000, http://dev.mysite.com)
Number of agents: 3 (default), 5 agents, 2 agents - more agents = more thorough testing
Headless mode: non-headless (default) or headless

Requirements

Python 3.11+
Google API key (get one) (we support gemini-2.0-flash)
Cursor/Claude with MCP support

Full Demo

CLAUDE_CODE_AUDIO-small.mp4

License

MIT

sauravpanda/vibetest-use