Better AI Browser Utilities (BABU)

既に使用しているChromeセッション（タブ、Cookie、ログインなどすべて）に対するトークン効率の良いMCP制御。BABUは、別の自動化プロファイルを起動する代わりに、MCP互換のコーディングエージェントをローカルのChrome拡張機能に接続します。

BABUが選ばれる理由

• 20個の反復的なブラウザツールの代わりに、デフォルトで4つのコンパクトなMCPスキーマを提供。

• 段階的開示: browser_read は制限付きテキストとコンパクトなコントロールを返し、browser_help は要求された場合にのみコマンドの詳細を表示します。

• 高速アクション: browser_do は、ナビゲーション、クリック、入力、キー、スクロール、待機、スクリーンショット、JavaScript、ループバックファイルのアップロードをディスパッチします。

• 実際のブラウザ状態: 既存のChromeタブと認証済みセッションを使用します。

• ポータブル: uvx でGitHubから直接インストール。文書化されたすべてのクライアントは標準のMCP stdioを使用します。

• ローカルファースト: 唯一のネットワークリスナーは 127.0.0.1 にバインドされ、拡張機能のWebSocketには生成されたペアリングトークンが必要です。

公開されているMCP v2スキーマは、レガシーの20ツールサーフェスの 2,219トークン に対して、コンパクトモードでは 567トークン を測定します。つまり、モデルターンあたりのスキーマコンテキストが74.45%削減 されます（o200k_base、正規JSON、クライアントフレーミングを除く）。

アーキテクチャ

MCP client
   |  stdio (client-owned subprocess)
   v
BABU Python bridge
   |  authenticated WebSocket ws://127.0.0.1:8765
   v
BABU Chrome extension (MV3) -> your real Chrome tabs

インストール

前提条件: uv と Chrome 116以降。

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup

このコマンドは、バンドルされた拡張機能を ~/.babu/extension にエクスポートし、~/.babu/token を作成して、ペアリング用のトークンを一度だけ出力します。

Chromeの場合:

1. chrome://extensions を開きます。

2. デベロッパーモード を有効にします。

3. パッケージ化されていないものを読み込む を選択し、表示された拡張機能ディレクトリを選択します。

4. BABU拡張機能を開き、ペアリングトークンを貼り付けて、保存 を選択します。

安定版Chromeは自動の --load-extension インストールを受け付けなくなったため、一度だけ手動で読み込む必要があります。

MCPクライアントにBABUを追加する

次のstdio起動定義を使用します。

{
  "command": "uvx",
  "args": [
    "--from",
    "git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0",
    "babu",
    "mcp"
  ]
}

Hermes、Codex、Claude Code、Cursor、VS Code、Zed、ZCode、Gemini CLI、OpenCode、Cline、Windsurf、Pi、Agent Primeの正確なコマンドと設定ファイルは docs/CLIENTS.md にあります。

一度に1つのBABUプロセスだけがWebSocketポート8765を所有できます。新しいハーネスを起動する前に、別のBABU対応ハーネスを閉じてください。

MCPツール

browser_do コマンド:

list_tabs, get_active_tab, open_tab, close_tab, activate_tab, navigate,
get_state, snapshot, click, hover, type, select, press, scroll, extract_text, screenshot,
eval, upload_files, wait_for, back, forward, reload

推奨フロー:

1. 関連する query を指定して browser_read を呼び出します。

2. 返された要素インデックスを click または type とともに browser_do に渡します。

3. インデックスはドキュメントローカルであるため、ナビゲーションや大きなDOMの変更後は再読み取りします。

4. コマンドのパラメータが不明確な場合にのみ browser_help を使用します。

スクリーンショットはデフォルトでシステムの一時ディレクトリに保存されます。include_data_url=true が明示されていない限り、base64画像バイトはモデルコンテキストから除外されます。

CLIユーティリティ

babu setup [--force]            # export/update extension and create token
babu token                      # print the current pairing token
babu mcp                        # stdio MCP server, compact profile
babu relay list_tabs            # direct browser command without an MCP client
babu relay navigate '{"url":"https://example.com"}'

babu relay は、MCPよりもCLIツールを好む最小限のハーネスに役立ちます。

ツールプロファイル

• compact (デフォルト): 上記の4つのツール。

• legacy: アクションごとに1つのスキーマを好むクライアント向けの20の直接ブラウザツール。

• all: 両方のサーフェス。

--tool-profile compact|legacy|all または BABU_TOOL_PROFILE でプロファイルを選択します。

セキュリティ

BABUはログイン中のブラウザプロファイルを制御するため、強力なローカルツールとして扱ってください。

• WebSocketリスナーは 127.0.0.1 にのみバインドされます。MCPはstdioを介して送信されます。

• Chrome拡張機能のオリジンとクライアントロールが検証されます。

• 拡張機能とブリッジ間のチャネルは、~/.babu/token に保存されている256ビットトークンを使用します。

• 拡張機能のポップアップですべての制御を即座に無効にできます。

• パスワード、OTP、支払いフィールドは、通常の読み取りからは編集されます。

• browser_eval は、設計上、ページのメインワールドでJavaScriptを実行します。

• ファイルのアップロードでは、資格情報のない境界付きの直接ループバックHTTP(S) URLのみを受け入れます。

すべてのMCPツール呼び出しを確認し、各クライアントの承認コントロールを使用してください。

制限事項

• Chromeの内部ページ、Webストア、PDFビューア、アンロードされたタブ、iframeまたはシャドウルート内のコントロールは操作できません。

• 厳格なページCSPは browser_eval をブロックする可能性があります。DOMの読み取り/クリック/入力ツールは引き続き機能します。

• browser_press はEnter、Tab、および合成Escapeをサポートします。テキストには browser_type を使用してください。

• 更新後、パッケージ化されていない拡張機能を chrome://extensions から再読み込みする必要があります。

• サーバーは設計上、シングルクライアントおよびシングルブラウザ拡張機能です。

アップデート

uvx --from git+https://github.com/ItMeDiaTech/better-ai-browser-utilities@v0.1.0 babu setup --force

chrome://extensions でBABUを再読み込みし、MCPクライアントを再起動します。新しいリリースを採用するときは、クライアント設定のGitタグを変更してください。

ライセンス

MIT