JinDaGe - web-agent-qa MCP Details

article

README

🚀 operative.sh 网页评估代理 MCP 服务器

让编码代理自行调试，你有更好的事情要做。

🚀 快速开始

macOS/Linux 系统

前置条件：
- 安装 brew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 安装 npm：brew install npm
- 安装 jq：brew install jq
获取 API 密钥后运行安装程序（免费）：

# 欢迎检查安装脚本内容：curl -LSf https://operative.sh/install.sh | less -N
# 下载、安装并删除安装脚本
curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

重启你最喜欢的 IDE 以应用更改。
在聊天模式中发送提示以调用 web 评估工具！

Windows 系统（Cline）手动安装

# 1. 在 operative.sh 获取你的 API 密钥
# 2. 安装 uv (curl -LsSf https://astral.sh/uv/install.sh | sh)
# 3. uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install
# 4. 在 Cline 中启动代理（可能需要重启 Cline）

✨ 主要特性

🌐 导航你的网络应用：使用 BrowserUse（配合 operative 后端，速度提升 2x）
📊 捕获网络流量：请求被智能过滤并返回到上下文窗口
🚨 收集控制台错误：捕捉日志和错误信息
🤖 自主调试：代理调用 web QA 代理 MCP 服务器以测试代码是否按预期工作

📦 安装指南

系统依赖安装

在 macOS/Linux 系统中，需要安装 brew、npm 和 jq 作为前置条件。安装命令如下：

brew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
npm：brew install npm
jq：brew install jq

安装程序运行

获取 API 密钥后，运行以下命令进行安装：

# 欢迎检查安装脚本内容：curl -LSf https://operative.sh/install.sh | less -N
# 下载、安装并删除安装脚本
curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh

Windows 手动安装

在 Windows 系统的 Cline 环境中，按照以下步骤进行手动安装：

# 1. 在 operative.sh 获取你的 API 密钥
# 2. 安装 uv (curl -LsSf https://astral.sh/uv/install.sh | sh)
# 3. uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install
# 4. 在 Cline 中启动代理（可能需要重启 Cline）

🔧 技术细节

operative.sh 的 MCP 服务器通过浏览器使用的代理在你的代码编辑器中直接执行和调试网络应用程序，加速你的调试体验。

🔃 更新说明

执行 uv clean
刷新 MCP 服务器

🚨 注意事项

⚠️ 重要提示

初始工具调用 Playwright 时出现问题，已在 4/14 推出修复。

遇到任何问题欢迎在该仓库提交 Issue！

📋 变更日志

4/29 - 代理覆盖更新 - 在浏览器中暂停/播放/停止代理运行

💻 使用示例

MCP 服务器输出报告示例

📊 网页评估报告为 http://localhost:5173 完成！
📝 任务：测试 API 密钥删除流程，通过导航到 API 密钥部分，删除一个密钥并评估 UX。

🔍 代理步骤
  📍 1. 访问 → http://localhost:5173
  📍 2. 点击     “登录”        (按钮索引 0)
  📍 3. 填写用户名和密码
  📍 4. 提交表单
  📍 5. 点击进入 API 密钥管理
  📍 6. 复制并删除密钥
  📍 7. 验证删除成功

👁️  查看“Operative 控制中心”仪表盘获取实时日志。

星辰历史

由衷制作 operative.sh

web-agent-qa