Vibetest

v1.0.0Browser Automationstable

An MCP server that launches multiple Browser-Use agents to test websites for UI bugs, broken links, and accessibility issues. It supports automated testing of both live and localhost development sites using natural language prompts.

agentsbrowserclaudecursormcp
Share:
795
Stars
0
Downloads
0
Weekly
0/5

What is Vibetest?

Vibetest is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that launches multiple browser-use agents to test websites for ui bugs, broken links, and accessibility issues. it supports automated testing of both live and localhost development sites us...

An MCP server that launches multiple Browser-Use agents to test websites for UI bugs, broken links, and accessibility issues. It supports automated testing of both live and localhost development sites using natural language prompts.

This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server that launches multiple Browser-Use agents to t

Use Cases

Automated UI testing with Browser-Use agents
Bug, link, and accessibility issue detection
browser-use

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 17, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx vibetest-use

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Vibetest

Vibetest is an MCP server that orchestrates multiple Browser-Use agents to automatically test websites for UI bugs, broken links, and accessibility issues. It connects to live or localhost sites and drives real browser sessions powered by Gemini 2.0 Flash, letting developers run comprehensive vibe-checks on their frontends with a single natural-language prompt. Teams working on rapid front-end iteration use it to catch regressions before shipping without writing any Playwright or Selenium code.

Prerequisites

  • Python 3.11+ and uv (pip install uv) installed on your system
  • Google Gemini API key (GOOGLE_API_KEY) — obtain at aistudio.google.com
  • Playwright Chromium browser (installed during setup)
  • An MCP client such as Claude Desktop or Cursor
1

Clone the repository

Clone the vibetest-use repository from GitHub and enter the project directory.

git clone https://github.com/browser-use/vibetest-use.git
cd vibetest-use
2

Create a virtual environment and install dependencies

Use uv to create an isolated Python environment and install the package along with its dependencies.

uv venv
source .venv/bin/activate
uv pip install -e .
3

Install Playwright Chromium browser

Vibetest drives real browser sessions, so you need the Chromium browser and its system dependencies installed.

playwright install chromium --with-deps --no-shell
4

Locate the installed binary path

Note the full path to the vibetest-mcp binary inside your virtual environment — you will need it for your MCP client configuration.

which vibetest-mcp
# Example output: /full/path/to/vibetest-use/.venv/bin/vibetest-mcp
5

Configure your MCP client

Add Vibetest to your MCP client configuration file (e.g. claude_desktop_config.json), substituting the real binary path and your API key.

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

Restart your MCP client and verify

Restart Claude Desktop or your chosen MCP client so it picks up the new server entry. You should see Vibetest appear in the connected tools list.

Vibetest Examples

Client configuration

Complete claude_desktop_config.json entry for the Vibetest MCP server.

{
  "mcpServers": {
    "vibetest": {
      "command": "/Users/yourname/vibetest-use/.venv/bin/vibetest-mcp",
      "env": {
        "GOOGLE_API_KEY": "AIza..."
      }
    }
  }
}

Prompts to try

Use these natural-language prompts in your MCP client after connecting Vibetest.

- "Vibetest my website with 5 agents: https://example.com"
- "Run vibetest on localhost:3000 and report any broken links"
- "Run a headless vibetest on localhost:8080 with 10 agents"
- "Test https://myapp.com for accessibility issues using 3 browser agents"

Troubleshooting Vibetest

Playwright fails with missing system libraries during browser launch

Re-run 'playwright install chromium --with-deps --no-shell' inside the activated virtual environment to install all OS-level dependencies Chromium needs.

GOOGLE_API_KEY error or agents fail to start

Make sure GOOGLE_API_KEY is set correctly in the MCP server env block and that your key has the Gemini API enabled in Google AI Studio.

MCP client does not show Vibetest in the tools list

Verify the 'command' path points to the vibetest-mcp binary inside the .venv directory, not a system Python. Use 'which vibetest-mcp' (with the venv activated) to confirm the path.

Frequently Asked Questions about Vibetest

What is Vibetest?

Vibetest is a Model Context Protocol (MCP) server that mcp server that launches multiple browser-use agents to test websites for ui bugs, broken links, and accessibility issues. it supports automated testing of both live and localhost development sites using natural language prompts. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Vibetest?

Follow the installation instructions on the Vibetest GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Vibetest?

Vibetest works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Vibetest free to use?

Yes, Vibetest is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Browser Automation MCP Servers

Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "vibetest-use": { "command": "npx", "args": ["-y", "vibetest-use"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Vibetest?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides