AI导哈

浏览器自动化驱动服务

MCP UI Human Driver是一个模拟人类用户操作浏览器的服务器，提供屏幕截图、鼠标键盘操作及测试后验证功能。

  • by laundryguy77
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 laundryguy77/mcp-humandriver

使用说明

MCP UI人工驱动程序（编剧）

驱动真实浏览器的MCP（模型上下文协议）服务器 像人类用户一样:

  • 感知：返回屏幕截图（默认情况下使用base64图像块）
  • 行动：仅限鼠标+键盘（单击、键入、按下、滚动、拖动）
  • 不许偷看 测试期间：没有DOM检查，没有通过工具访问网络/控制台
  • 测试后验证 工具是封闭的，只有在以下情况下才能使用 ui.end_test_phase

快速启动

需求

  • Node.js>=18
  • Ubuntu deps： npx playwright install --with-deps

安装+构建

npm install
npx playwright install --with-deps
npm run build

运行（手动）

这是一个 标准 MCP服务器。大多数MCP主机都会为您启动它。

npm run start

配置MCP主机（stdio）

命令示例：

  • 命令： node
  • args： [ "/ABSOLUTE/PATH/TO/PROJECT/build/index.js" ]

输出工件

每次跑步都会产生 runs/<runId>/:

  • screenshots/step_0001.png ...
  • actions.jsonl
  • observations.jsonl
  • manifest.json
  • network.jsonl （静默捕获；仅在测试后通过验证器可用）
  • console.jsonl （静默捕获；仅在测试后通过验证器可用）

身份持久性：

  • profiles/<agentId>/ （剧作家持续语境）

严格导航注意事项（“禁止传送”）

默认情况下， ui.goto() 受到限制：

  • 只允许 第一 导航到 baseUrl 根
  • 之后，通过UI导航（点击/键入）
  • 用以下方式覆盖 force=true （已记录）

工具列表

UI驱动程序：

  • ui.newrun、ui.close_run、ui.screenshot、ui.viewport、ui.goto
  • ui.点击，ui.click-rel，ui.drag，ui.drac_rel，ui.scroll，ui.type，ui.press
  • ui.wait，ui.wait_for_stable
  • ui.set_mode，ui.require_mode_order
  • ui.record_观察，ui.end_test_phase

验证者（门控）：

  • verify.collect_browser_console
  • verify.collect_network_summary

相关 MCP