Bezlo MCP

Bezlo — オープンなエージェントレイヤー

Bezlo は、あらゆるウェブページを実寸大の iPhone／iPad／Android フレーム内に表示し、 AI エージェントがそのページを確認して操作できるようにします。スクリーンショット、操作可能な要素の一覧、レイアウト診断（オーバーフロー、安全領域、タッチ識別情報）、コンソール／ページのエラー、ネットワークモック、タップ／入力／スクロールのフロー、デバイスマトリックスでの実行に加え、report.json／JUnit／mp4 の証跡を提供します。

このリポジトリは、MIT ライセンスのエージェントレイヤーです。

• mcp/ — MCP stdio サーバー＋CLI＋セッション／キャプチャエンジン（npm では bezlo-mcp としても公開）
• action.yml + examples/ — 複合 GitHub Action（PR のスクリーンショット＋JUnit＋動画）
• skill/ — Claude Code／スキル互換エージェント向けの 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 ブランドはこのライセンスの対象ではなく、このリポジトリにも含まれていません。