Vibetest 使用

使用 Browser-Use 代理进行自动化 QA 测试。

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

一个 MCP 服务器，可启动多个 Browser-Use 代理，用于测试由 Vibe 编码的网站是否存在 UI 错误、失效链接、无障碍问题及其他技术性问题。

非常适合测试线上网站和本地开发环境中的站点。

用 Vibecode 和 Vibetest 不断调试，直到你的网站运行正常为止。

快速入门

# 安装依赖
uv venv
source .venv/bin/activate
uv pip install -e .

# 安装浏览器
playwright install chromium --with-deps --no-shell

1) Claude Code

# 通过 CLI 添加 MCP 服务器
claude mcp add vibetest /full/path/to/vibetest-use/.venv/bin/vibetest-mcp -e GOOGLE_API_KEY="your_api_key"

# 在 Claude Code 中测试
> claude

> /mcp 
  ⎿  MCP 服务器状态

     • vibetest: 已连接

2) Cursor（手动）

1. 通过 MCP 设置界面安装：
   • 打开 Cursor 设置
   • 点击左侧边栏中的“MCP”
   • 点击“添加服务器”或“+”按钮
   • 手动编辑配置：

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

基本提示

> 用 5 个 Browser-Use 代理测试我的网站：browser-use.com
> 在 localhost:3000 上运行 Vibetest
> 在 localhost:8080 上以无头模式运行 Vibetest，使用 10 个代理

可指定的参数

• URL：任意网站（https://example.com、localhost:3000、http://dev.mysite.com）
• 代理数量：3（默认）、5 个代理、2 个代理——代理越多，测试越全面
• 无头模式：非无头（默认）或无头

需求

• Python 3.11+
• Google API 密钥（获取方法）（我们支持 gemini-2.0-flash）
• 支持 MCP 的 Cursor 或 Claude

完整演示

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

许可证

MIT

---

由 Browser Use 提供技术支持

Vibetest Use 快速上手指南

Vibetest Use 是一个基于 Browser-Use 代理的自动化 QA 测试工具（MCP 服务器）。它能启动多个智能体并行测试网站，自动发现 UI 缺陷、死链、无障碍问题及其他技术故障。适用于生产环境网站及本地开发环境（localhost）。

环境准备

在开始之前，请确保满足以下系统要求：

• 操作系统：Linux, macOS 或 Windows (WSL)
• Python 版本：3.11 或更高版本
• 依赖工具：
  • uv (推荐的 Python 包管理器和虚拟环境工具)
  • Playwright (用于浏览器自动化)
• API 密钥：需要有效的 Google API Key (支持 gemini-2.0-flash 模型)。
  • 获取地址：Google Developers
• 客户端支持：需安装支持 MCP 协议的 AI 编辑器，如 Cursor 或 Claude Code。

国内开发者提示：如果访问 Google API 受限，请自行配置网络代理或在环境变量中设置代理地址。安装 Playwright 浏览器内核时若下载缓慢，可尝试配置国内镜像源或使用梯子。

安装步骤

1. 安装项目依赖与浏览器

打开终端，执行以下命令来创建虚拟环境、安装项目包以及下载 Chromium 浏览器内核：

# 创建并激活虚拟环境
uv venv
source .venv/bin/activate  # Windows 用户请使用: .venv\Scripts\activate

# 安装当前项目
uv pip install -e .

# 安装 Playwright 浏览器内核 (Chromium)
# 注意：国内网络环境下若下载失败，请确保网络代理生效
playwright install chromium --with-deps --no-shell

2. 配置 MCP 服务器

根据你的开发工具选择以下一种方式进行配置：

方案 A：Claude Code (命令行配置)

将 vibetest 添加为 MCP 服务器。请将 /full/path/to/vibetest-use 替换为你本地的实际项目路径，并将 your_api_key 替换为你的 Google API Key。

claude mcp add vibetest /full/path/to/vibetest-use/.venv/bin/vibetest-mcp -e GOOGLE_API_KEY="your_api_key"

验证连接：

> claude
> /mcp 
  ⎿  MCP Server Status
     • vibetest: connected

方案 B：Cursor (手动配置文件)

1. 打开 Cursor 设置，点击左侧边栏的 MCP。
2. 点击 Add Server 或 + 号，选择手动编辑配置。
3. 在配置文件中填入以下内容（同样请替换实际路径和 API Key）：

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

基本使用

配置完成后，直接在 Claude Code 或 Cursor 的对话框中输入自然语言指令即可启动测试。

常用指令示例：

• 测试在线网站（默认 3 个代理）：

  Vibetest my website with 5 agents: browser-use.com
  

• 测试本地开发服务：

  Run vibetest on localhost:3000
  

• 无头模式（Headless）高强度测试：

  Run a headless vibetest on localhost:8080 with 10 agents
  

参数说明：

• URL：支持任意网址（如 https://example.com, localhost:3000）。
• 代理数量：可通过 5 agents 指定，数量越多测试越详尽（默认为 3）。
• 运行模式：默认为有界面模式 (non-headless)，可指定 headless 进行后台静默测试。