返回 MCP 目录
public公开dns本地运行

web-qa-agent

operative.sh的MCP服务器是一个自动化网页调试代理工具,能够在代码编辑器中自主执行和调试网页应用,提供网络请求捕获、控制台错误收集等功能。

article

README

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

operative.sh 网页评估代理服务器 MCP 服务器可让编码代理自行调试,让你有更多精力去处理其他重要事务。

演示

🚀 快速开始

macOS/Linux 系统

  1. 安装先决条件
    • 安装 brew:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    • 安装 npm:brew install npm
    • 安装 jq:brew install jq
  2. 获取 API 密钥并运行安装程序:在 operative.sh 获取免费的 API 密钥后运行安装程序。
# 欢迎 inspect 安装脚本如下:
# 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
  1. 重启 IDE:访问你常用的 IDE 并重启以应用更改。
  2. 调用工具:发送提示在聊天模式中调用 web 评估代理工具!

Windows 系统(手动命令行界面安装)

# 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. 使用命令行界面 unleash 代理(可能需要重启 Cline)

✨ 主要特性

  • 🌐 网页应用导航:使用 BrowserUse(内置 operative 后端,速度提升 2 倍)来导航你的网页应用。
  • 📊 网络流量捕获:请求会被智能过滤并返回到上下文窗口。
  • 🚨 控制台错误收集:捕获日志和错误。
  • 🤖 自主调试:代理调用 web QA 代理 MCP 服务器以测试代码是否按预期工作。

📦 安装指南

macOS/Linux 系统

  1. 安装 brew、npm 和 jq。
  2. 获取 API 密钥后运行安装脚本。
  3. 重启 IDE。

Windows 系统

  1. 获取 API 密钥。
  2. 安装 uv。
  3. 执行 uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install
  4. 使用命令行界面 unleash 代理。

🔧 技术细节

更新操作

  • uv clean
  • 刷新 MCP 服务器

问题处理

  • 初始工具调用 Playwright 出现问题,已修复,请参见 4/14 推送内容,使用 npm install -g playwright 解决工具调用中的 Playwright 问题。
  • 遇到任何问题欢迎在该仓库提交 Issue!

变更日志

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

📚 详细文档

MCP 服务器输出报告示例

📊 网页评估报告 http://localhost:5173 完成!
📝 任务:评估代理执行特定操作
### 结论:
- 代理成功导航至指定页面
- 执行时间符合预期
- 操作结果与预期一致

### 细节:

构建于 ❤️ @ operative.sh

即贴即用配置

MCP 客户端配置生成器

选择客户端,补齐所需环境变量,再复制根据当前 MCP 公开配置生成的完整文件

terminal
data_object

当前条目没有标准 command 或远程 URL,暂时无法安全生成客户端配置

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端