Sandbox
@browser-use/vibetest-use

MCP server for Browser-Use website QA

Vibetest Use connects Claude Code or Cursor to a Browser-Use QA runner through MCP. You point it at a site, and it spins up multiple agents to look for UI bugs, broken links, accessibility issues, and other technical problems.

830 stars83 forksPythonUpdated 1y ago
Who it's for

Builders who want their agent to test a live site or localhost app for bugs and broken flows.

What it delivers

You can ask your agent to run multi-agent website QA instead of checking every issue by hand.

What it does

Multi-agent website testing

Launches multiple Browser-Use agents against one URL for broader QA coverage.

Live and localhost support

Tests public websites and local development sites like `localhost:3000`.

MCP integration

Exposes the tester as an MCP server for Claude Code and Cursor.

Headless and non-headless runs

Supports both visible browser runs and headless testing.

Bug-focused checks

Looks for UI bugs, broken links, accessibility issues, and other technical problems.

How to get it

  1. 1Run
    # Install dependencies
    uv venv
    source .venv/bin/activate
    uv pip install -e .
    
    # Install the browser
    playwright install chromium --with-deps --no-shell
  2. 2Run
    > Vibetest my website with 5 agents: browser-use.com
    > Run vibetest on localhost:3000
    > Run a headless vibetest on localhost:8080 with 10 agents

README

Vibetest Use

Automated QA testing using Browser-Use agents.

https://github.com/user-attachments/assets/9558d051-78bc-45fd-8694-9ac80eaf9494

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 .

# Install the browser
playwright install chromium --with-deps --no-shell

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 (manually)

  1. 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

https://github.com/user-attachments/assets/6450b5b7-10e5-4019-82a4-6d726dbfbe1f

License

MIT


Powered by Browser Use

Files in the repo

Repository payload5 top-level entries
  • vibetest
  • vibetest.egg-info
  • .gitignore
  • pyproject.toml
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k
t8y2/dbxConnectors

20 MB lightweight cross-platform database client for 90+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 90+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP Server。

19k