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//:

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

身份持久性：

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

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

默认情况下， 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