Bezlo MCP

Bezlo — 开放式 Agent 层

Bezlo 可将任意网页放入真实尺寸的 iPhone / iPad / Android 设备框架中，让 AI Agent 查看并与其交互：截图、交互元素列表、布局诊断（溢出、安全区域、触摸标识）、控制台/页面错误、网络模拟、点击/输入/滚动流程、设备矩阵运行，以及 report.json / JUnit / mp4 证据。

此仓库是采用 MIT 许可的 Agent 层：

• mcp/ — MCP stdio 服务 + CLI + 会话/捕获引擎（也以 bezlo-mcp 的名称发布于 npm）
• action.yml + examples/ — 组合式 GitHub Action（PR 截图 + JUnit + 视频）
• skill/ — 供 Claude Code / 兼容 skills 的 Agent 使用的 bezlo-preview 技能
• server.json — 官方 MCP 注册表清单
• docs/MCP.md — 完整的工具参考

Chrome 扩展本身为专有软件，存放在单独的私有仓库中（extension/、商店素材、品牌内容）。此仓库不包含扩展代码、商店素材或品牌插画。Bezlo 名称和徽标未授权复用。

安装

# MCP (Claude Code / Claude Desktop / Cursor)
npm install -g bezlo-mcp
claude mcp add bezlo -- npx -y bezlo-mcp

# or run from a checkout
node mcp/cli.mjs --list

此软件包不捆绑浏览器：请安装 Chrome/Chromium（或设置 RP_CHROME）。推荐使用 Chrome for Testing；WebKit 模式还需要运行 npx playwright install webkit。

CLI 快速入门

node mcp/cli.mjs --url http://localhost:3000 --device iphone16 --out shot.png
node mcp/cli.mjs --url http://localhost:3000 --matrix --devices iphone16,ipadpro11,px10 --out ./matrix
node mcp/cli.mjs --url http://localhost:3000 \
  --actions '[{"type":"click","text":"Sign in"},{"type":"type","selector":"#email","value":"[email protected]","submit":true}]' \
  --record --assert '[{"type":"noOverflow"},{"type":"noConsoleErrors"}]' --out after.png

GitHub Action

- uses: gba3124/bezlo@main
  id: bezlo
  with:
    url: http://localhost:3000
    device: iphone16
    steps: '[{"type":"click","text":"Sign in"}]'
    asserts: '[{"type":"noOverflow"},{"type":"noConsoleErrors"}]'
    record: 'true'

构件：最终截图、report.json、junit.xml、可选的 mp4/gif。 输出：pass、report、junit、video、gif、screenshot、artifacts。

引擎

• chromium（默认）— Chrome 自带的仿真引擎（与扩展的设备框架相同）：真实触摸、移动端 UA 和客户端提示、DPR；完整录制和 CDP 无障碍支持。
• webkit — Playwright WebKit，一种 Safari 风格的近似实现（并非真正的 iOS Safari；不支持录制 / CDP 无障碍）。

许可证

MIT — 参见 LICENSE。Chrome 扩展、商店素材和 Bezlo 品牌不受此许可证涵盖，也不属于此仓库的一部分。