Browser Bridge

AI ↔ ブラウザ制御ブリッジ:ブラウザを MCP ツールセットに変えます。任意の MCP クライアント(AI プログラム)が標準 MCP プロトコルを通じて browser_snapshot / browser_click / browser_type などのツールを呼び出し、実際のブラウザで Web ページを操作します。

• 任意の MCP クライアントに対応:Claude、codex、カスタム agent、curl

• デフォルトはフォローモード:AI が現在アクティブなタブを自動制御、ゼロ設定

• 実際のブラウザ、headless ではない:ログイン状態、CAPTCHA(手動入力を促す)、アンチスクレイピング特性が自然

クイックスタート

1. ダウンロード

Releases から1つのアーカイブをダウンロード:

• browser-bridge-<platform>-<arch>.zip — お使いのマシンのプラットフォームに合わせて選択

任意のディレクトリに解凍(以下 <DIR> と表記)。ディレクトリ内には browser-bridge/(拡張機能)、browser-bridge-host、install-host.sh(Windows では install-host.ps1)が含まれます。

2. 拡張機能を読み込む

1. chrome://extensions を開く

2. 右上のデベロッパーモードをオンにする

3. 「パッケージ化されていない拡張機能を読み込む」をクリックし、解凍した browser-bridge/ ディレクトリを選択

3. host をインストール

macOS / Linux:

cd <DIR>
./install-host.sh         # Windows(PowerShell): .\install-host.ps1

実行すると検出されたブラウザが一覧表示され、Enter で全てにインストール、または番号を入力して特定のブラウザを選択。引数で直接指定することも可能:

./install-host.sh --all      # 安装到全部浏览器
./install-host.sh --chrome   # 只装 Chrome(--chromium / --edge 同理)

拡張機能 ID は内蔵で固定されており、手動入力は不要。拡張機能 ID が異なる場合は、追加引数で指定:./install-host.sh <あなたの拡張機能ID>。

ブラウザが既に開いている場合は、インストール後に完全に終了してブラウザを再起動してください。

4. 使用

任意の MCP クライアントで接続:

MCP server: http://127.0.0.1:1234/mcp

ポートが使用中の場合は自動的に +1 され、実際のポートは拡張機能のポップアップ(接続済み · MCPポート xxxx)または ~/.browser-bridge/port で確認できます。

codex 設定例(~/.codex/config.toml):

[mcp_servers.browser]
url = "http://127.0.0.1:1234/mcp"

あとは AI に「このページを見て…」と指示するだけです。

Related MCP server: BrowserPilot

MCP ツール

AI が自ら編成:snapshot → 判断 → 操作 → 再度 snapshot、タスク完了まで繰り返します。

制御モード

• フォローモード(デフォルト):現在アクティブなタブを制御。タブを切り替えると対象も切り替わる

• 固定モード:特定のタブをロック(切り替えても追従しない)。ポップアップでワンクリック固定/解除、または AI が browser_use_tab を呼び出し

ツールバーアイコンのバッジ:なし = フォロー中;AI 琥珀色 = 固定中;! 赤 = 接続異常。

アーキテクチャ

任意 MCP 客户端
   │ MCP (Streamable HTTP, 127.0.0.1:1234/mcp)
browser-bridge host(单进程 = MCP ↔ 帧协议翻译器)
   │ native messaging(stdin/stdout 帧)
Chrome 扩展
   ├─ background:转发、目标解析、保活、状态徽标
   └─ content script:快照 / 执行

MV3 拡張機能はポートをリッスンできないため、native host が唯一のチャネルです(Chrome 公式 DevTools MCP と同構造)。

ソースからビルド(開発者向け)

bun が必要:

bun install
bun run build                    # 当前平台 host + 扩展
./scripts/install-host.sh        # 注册 host(默认内置扩展 ID)
bun run scripts/build.ts --all   # 交叉编译全部平台 + 发布包(发布用)
bun test                         # 单元 + MCP API 集成测试(无需浏览器)

設定

• BROWSER_BRIDGE_PORT:MCP 初期ポート(デフォルト 1234、使用中は自動 +1)

• BROWSER_BRIDGE_MOCK=1:拡張機能の応答をモック(開発テスト用)

トラブルシューティング

License

MIT