AI导哈

网页调试代理服务器

operative.sh的MCP服务器提供一个浏览器驱动的代理，用于在代码编辑器中自主执行和调试网页应用。

  • by refreshdotdev
  • Python
  • 本地部署
  • 1231 星标
  • 更新于
在 GitHub 查看 Operative-Sh/web-eval-agent

使用说明

⚠️ 项目已经日落⚠️

该项目已终止。我们正在建造一些新的东西 withrefresh.com

🚀 operave.sh web评估代理MCP服务器

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

🔥 增强您的调试能力

operave.sh的MCP Server启动了一个浏览器驱动的代理，直接在代码编辑器中自主执行和调试web应用程序。

⚡ 特性

  • 🌐 浏览您的网络应用程序 使用BrowserUse（使用操作后端速度提高2倍）
  • 📊 捕获网络流量 -请求被智能过滤并返回到上下文窗口中
  • 🚨 收集控制台错误 -捕获日志和错误
  • 🤖 自主调试 -Cursor代理调用web QA代理mcp服务器，以测试它编写的代码是否按预期端到端工作。

🧰 MCP工具参考

工具 目的
web_eval_agent 🤖 自动用户体验评估器，驱动浏览器，捕获屏幕截图、控制台和网络日志，并返回丰富的用户体验报告。
setup_browser_state 🔒 打开一个交互式（非无头）浏览器，以便您可以登录一次；保存的Cookie/本地存储将由后续用户重复使用 web_eval_agent 跑。

关键参数

  • web_eval_agent

    • url （必填） –正在运行的应用程序的地址（例如。 http://localhost:3000)
    • task （必填） –测试内容的自然语言描述（“浏览注册流程并注意任何用户体验问题”）
    • headless_browser （可选，默认 false) –设置为 true 隐藏浏览器窗口

  • setup_browser_state

    • url （可选） –首先打开的页面（方便直接登录屏幕）

您可以直接从IDE聊天中触发这些工具，例如：

Evaluate my app at http://localhost:3000 – run web_eval_agent with the task "Try the full signup flow and report UX issues".

🏁 快速开始

一键集成，轻松设置

  1. 获取API密钥（免费） -当您创建API密钥时，您将看到：
    • “添加到光标” 带有深度链接的按钮，用于即时安装Cursor
    • 预填充的Claude Code命令 自动包含API密钥

手动设置（macOS/Linux）

  1. 先决条件（通常不需要）：
  • 酿造： /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  • npm：(brew install npm)
  • jq： brew install jq
  1. 运行安装程序后 获取api密钥（免费）
    • 安装 剧作家
    • 安装uv
    • 为您将JSON插入代码编辑器（Cursor/Cline/Windsurf）！
curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh
  1. 访问您最喜欢的IDE并重新启动以应用更改
  2. 在聊天模式下发送提示以调用web eval代理工具！例如
Test my app on http://localhost:3000. Use web-eval-agent.

🛠️ 手动安装

  1. 在operative.sh/mcp获取API密钥
  2. 安装uv
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. 安装UV后的源环境变量

苹果电脑

source ~/.zshrc

Linux

source ~/.bashrc
  1. 安装剧作家：
npm install -g chromium playwright && uvx --with playwright playwright install --with-deps
  1. 使用api键将以下JSON添加到您的相关代码编辑器中
  2. 重新启动代码编辑器

🔃 更新中

  • uv cache clean
  • 刷新MCP服务器
    "web-eval-agent": {
      "command": "uvx",
      "args": [
        "--refresh-package",
        "webEvalAgent",
        "--from",
        "git+https://github.com/Operative-Sh/web-eval-agent.git",
        "webEvalAgent"
      ],
      "env": {
        "OPERATIVE_API_KEY": "<YOUR_KEY>"
      }
    }

操作Discord服务器

🛠️ 手动安装（Mac+Cursor/Cline/Windsurf）

  1. 在operative.sh/mcp获取API密钥
  2. 安装uv
curl -LsSf https://astral.sh/uv/install.sh | sh)
  1. 安装剧作家：
npm install -g chromium playwright && uvx --with playwright playwright install --with-deps
  1. 使用api键将以下JSON添加到您的相关代码编辑器中
  2. 重新启动代码编辑器

手动安装（Windows+光标/鼠标/风帆）

我们正在对此进行改进，如果您有任何问题，请打开一个问题！

  1. 在代码编辑器终端中执行所有这些操作
  2. curl -LSf https://operative.sh/install.sh -o install.sh && bash install.sh && rm install.sh
  3. 在operative.sh/mcp获取API密钥
  4. 安装uv (curl -LsSf https://astral.sh/uv/install.sh | sh)
  5. uvx --from git+https://github.com/Operative-Sh/web-eval-agent.git playwright install
  6. 重新启动代码编辑器

🚨 问题

  • 代码编辑器中未收到更新，请更新或重新安装最新版本：运行 uv cache clean 最新
  • 任何问题都可以在这个回购或不和谐的情况下自由发行！
  • 5/5-没有更改的静态应用程序无法进行屏幕录制，已修复！ uv clean +重新启动以获取修复

更新日志

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

📋 MCP服务器输出报告示例

📊 Web Evaluation Report for http://localhost:5173 complete!
📝 Task: Test the API-key deletion flow by navigating to the API Keys section, deleting a key, and judging the UX.

🔍 Agent Steps
  📍 1. Navigate → http://localhost:5173
  📍 2. Click     "Login"        (button index 2)
  📍 3. Click     "API Keys"     (button index 4)
  📍 4. Click     "Create Key"   (button index 9)
  📍 5. Type      "Test API Key" (input index 2)
  📍 6. Click     "Done"         (button index 3)
  📍 7. Click     "Delete"       (button index 10)
  📍 8. Click     "Delete"       (confirm index 3)
🏁 Flow tested successfully – UX felt smooth and intuitive.

🖥️ Console Logs (10)
  1. [debug] [vite] connecting…
  2. [debug] [vite] connected.
  3. [info]  Download the React DevTools …
     …

🌐 Network Requests (10)
  1. GET /src/pages/SleepingMasks.tsx                   304
  2. GET /src/pages/MCPRegistryRegistry.tsx             304
     …

⏱️ Chronological Timeline
  01:16:23.293 🖥️ Console [debug] [vite] connecting…
  01:16:23.303 🖥️ Console [debug] [vite] connected.
  01:16:23.312 ➡️ GET /src/pages/SleepingMasks.tsx
  01:16:23.318 ⬅️ 304 /src/pages/SleepingMasks.tsx
     …
  01:17:45.038 🤖 🏁 Flow finished – deletion verified
  01:17:47.038 🤖 📋 Conclusion repeated above
👁️  See the "Operative Control Center" dashboard for live logs.

星迹

内置<3@ operave.sh

相关 MCP