Skip to main content
Glama
deenesjakoruzh
weaming

browser-bridge

by weaming
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

Browser Bridge

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

  • 任意の MCP クライアントに対応:Claude、codex、カスタムエージェント、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 されます。実際のポートは拡張機能の popup(接続済み · MCP ポート xxxx)または ~/.browser-bridge/port で確認できます。

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

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

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

Related MCP server: Playwright MCP Server

MCP ツール

ツール

パラメータ

説明

browser_control_status

—

制御対象と接続状態を照会

browser_list_tabs

—

すべてのタブを一覧表示

browser_use_tab

tabId(-1 でフォローに戻る)

制御対象を固定/切り替え

browser_new_tab

url?

新しいタブを作成して即座に移動(省略時は空白ページ)

browser_close_tab

tabId?

タブを閉じる(省略時は制御中のページを閉じ、自動でフォローに戻る)

browser_activate_tab

tabId

ユーザーに見えるようにタブをアクティブ化(制御対象は変更しない)

browser_duplicate_tab

tabId?

タブを複製(省略時は制御中のページを複製)

browser_pin_tab

tabId?, pinned?

タブを固定/固定解除

browser_snapshot

—

操作可能な要素のスナップショット(ref 番号+座標)

browser_extract

format?(markdown|html|raw)

本文を抽出。会話ページ(ChatGPT/Gemini)は Q&A のターンごとに組み立て。format=html はサニタイズ済み HTML、raw は元の body HTML を返す

browser_screenshot

—

表示領域のスクリーンショット(dataUrl、複雑なレイアウトの視覚的理解用)

browser_url

—

現在の制御ページの URL とタイトルを照会(軽量)

browser_click

ref, button?

クリック

browser_dblclick

ref

ダブルクリック

browser_type

ref, text, clear?

入力(React の制御コンポーネント対応)

browser_form_fill

fields[]

複数のフィールドを一括入力

browser_press / browser_key

key, modifiers?

キー操作(ctrl/shift/alt/meta 対応)

browser_select

ref, value

ドロップダウン

browser_scroll

dir, amount?, ref?

スクロール

browser_hover

ref

ホバー

browser_highlight

ref

要素を 1 秒間ハイライト(ユーザーに AI の操作位置が見える)

browser_drag

fromRef, toRef

HTML5 ドラッグ

browser_goto

url

指定 URL へ移動

browser_back

—

ブラウザの戻る

browser_refresh

—

ページを更新

browser_wait_for

ms または selector または text(3 つのうち 1 つ、組み合わせ不可)

待機:タイマー(ms≤60s)、または要素の出現、またはページテキストの出現(UI 条件は最大 5s)

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

制御モード

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

  • 固定モード:特定のタブにロック(切り替えてもフォローしない)。popup でワンクリック固定/解除、または 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:拡張機能の応答をモック(開発テスト用)

トラブルシューティング

現象

原因

解決

popup に「host 未接続」と表示

host 未インストール / ブラウザ未再起動

install-host を実行し、ブラウザを完全に終了して再起動

Invalid native messaging host name

host 名にハイフンが含まれる(旧バージョン)

新バージョンに更新(host 名 com.browserbridge)

拡張 ID が一致しない

旧版 manifest で読み込んでいる

拡張機能を再ダウンロード、または install-host に引数 install-host.sh <あなたのID> を渡す

MCP に接続できない

host が実行されていない

先にブラウザ+拡張機能を開く(host は Chrome が起動)

対象タブに到達できない

ページ未準備 / http(s) ではない

ページの読み込みを待つ、または browser_use_tab で固定

ライセンス

MIT

This server cannot be deployed

Give agents eyes on the webHosted screenshot MCP. Send a URL, get a pixel-perfect image. $0.002 per grab. Works with Claude, Cursor, and Codex.grabbit.liveAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • BrowserPilot

    soulxyz
    F
    license
    B
    quality
    D
    maintenance
    Enables AI to control browsers via natural language for web automation, testing, and data scraping. Supports Chrome-based browsers and integrates with any MCP-compatible AI tool.
    17
    2
    -

  • Chrome MCP Bridge

    randyrt
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to control and interact with a Chrome browser via MCP, providing tools for navigation, screenshots, clicking, form filling, content extraction, and tab management.
    -