browserdebug

browserdebug

CLI と stdio MCP サーバーを 1 つのバイナリで提供する、Chrome DevTools スタイルのデバッグツールです。パフォーマンストレースを記録して分析結果を読み取り、ネットワークリクエストの一覧表示と詳細確認、コンソールメッセージの読み取り、テキストスナップショットとスクリーンショットの撮影、ネットワーク／CPU／デバイス環境のエミュレーション、要素 uid によるページ入力の操作を行えます。

ブラウザーは、注入可能なエグゼキューターインターフェイス（src/types.ts の DebugBrowser）を介して制御します。このパッケージにはブラウザーは含まれず、ダウンロードもされません。エグゼキューターが設定されていない場合、ブラウザー操作コマンドは「Browser unavailable」という明確なエラーで失敗します。デプロイ環境では、実際の Chrome を操作するため、DevTools プロトコル互換のエグゼキューターを注入してください。パフォーマンストレースのステートマシンはコアにあります。トレースを停止する前に開始する必要があり、二重に開始することはできません。

インストール

npx -y @reneturcios/browserdebug mcp

CLI

browserdebug mcp
browserdebug pages
browserdebug navigate <url>
browserdebug snapshot
browserdebug screenshot [file]
browserdebug --version

終了コード：0 は成功、1 はブラウザーエラー、2 は使用方法のエラーです。

MCP ツール

26 個のツール：click、drag、fill、fill_form、handle_dialog、hover、press_key、upload_file、close_page、list_pages、navigate_page、new_page、select_page、wait_for、emulate、resize_page、performance_analyze_insight、performance_start_trace、performance_stop_trace、get_network_request、list_network_requests、evaluate_script、get_console_message、list_console_messages、take_screenshot、take_snapshot。

MCP クライアントの設定：

{
  "mcpServers": {
    "browserdebug": {
      "command": "npx",
      "args": ["-y", "@reneturcios/browserdebug", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/browserdebug          # MCP server
docker run --rm ghcr.io/cloudcorprecords/browserdebug --version

開発

npm install
npm run build
npm test

MIT ライセンス。