Browser Bridge

AI ↔ Browser-Steuerungsbrücke:Verwandelt den Browser in ein MCP-Toolkit. Jeder MCP-Client (KI-Programm) kann über das standardmäßige MCP-Protokoll Werkzeuge wie browser_snapshot / browser_click / browser_type aufrufen, um Webseiten in einem echten Browser zu bedienen.

• Unterstützt beliebige MCP-Clients: Claude, codex, eigene Agents, curl

• Standardmäßig Follow-Modus: Die KI steuert automatisch den aktuell aktiven Tab, null Konfiguration

• Echter Browser, nicht headless: Login-Zustand, CAPTCHA (fordert dich manuell), Anti-Crawling-Funktionen natürlich

Schnellstart

1. Herunterladen

Lade aus Releases ein Archiv herunter:

• browser-bridge-<platform>-<arch>.zip — wähle basierend auf deiner Plattform

Entpacke in ein beliebiges Verzeichnis (im Folgenden als <DIR> bezeichnet), das Verzeichnis enthält browser-bridge/ (Erweiterung), browser-bridge-host, install-host.sh (für Windows install-host.ps1).

2. Erweiterung laden

1. Öffne chrome://extensions

2. Aktiviere oben rechts den Entwicklermodus

3. Klicke auf „Entpackte Erweiterung laden", wähle das browser-bridge/-Verzeichnis

3. Host installieren

macOS / Linux:

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

Nach dem Ausführen werden die erkannten Browser aufgelistet. Installiere alle oder wähle eine Nummer, um in alle zu installieren; alternativ kannst du auch Parameter direkt angeben:

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

Die Erweiterungs-ID ist fest codiert, du musst sie nicht manuell eingeben; falls deine Erweiterungs-ID anders ist, kannst du sie als Argument übergeben: ./install-host.sh <deine-ID>.

Falls der Browser bereits geöffnet ist, beende ihn nach der Installation vollständig und starte ihn neu.

4. Verwenden

Beliebiger MCP-Client verbindet sich:

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

Wenn der Port belegt ist, wird automatisch ein anderer verwendet (siehe Popup der Erweiterung „Verbunden · Port xxx“) bzw. ~/.browser-bridge/port.

Beispiel für codex-Konfiguration (~/.codex/config.toml):

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

Danach kannst du der KI sagen: „Schau dir diese Seite an …“

Related MCP server: BrowserPilot

MCP-Tools

KI orchestriert selbst: Snapshot → Aktion → nächster Snapshot, bis die Aufgabe erledigt ist.

Steuermodi

• Folgemodus (Standard): Steuert den aktuell aktiven Tab, Tab-Wechsel wechselt das Ziel

• Fester Modus: Fixiert einen Tab (folgt nicht bei Tab-Wechsel); über Popup oder browser_use_tab per KI

Popup-Anzeige: kein Symbol = Folgemodus; ! = fixiert; ! rot = Fehler?

Actually, we need to translate that part. Let's continue.

Original:

控制模式

• 跟随模式(默认):控制你当前激活的标签页,切 tab 即切目标

• 固定模式:锁定某个标签页(切换不跟随);popup 一键固定/取消,或 AI 调 browser_use_tab

工具栏图标徽标:琥珀 AI 表示固定,红色表示连接异常。

Wait, original: 工具栏图标徽标:无 = 跟随中;AI 琥珀 = 固定;! 红 = 连接异常。

Let's read the original text:

控制模式

• 跟随模式(默认):控制你当前激活的标签页,切 tab 即切目标

• 固定模式:锁定某个标签页(切换不跟随);popup 一键固定/取消,或 AI 调 browser_use_tab

工具栏图标徽标:无 = 跟随中;琥珀 AI = 已固定;红 ! = 连接异常。(Note: The original said "工具栏图标徽标:无 = 跟随中;AI 琥珀 = 已固定;红 = 连接异常。" but we have to translate exactly. Let's look at the original: "工具栏图标徽标:无 = 跟随中;AI 琥珀 = 已固定;! 红 = 连接异常。" Actually the original says: "工具栏图标徽标:无 = 跟随中;AI 琥珀 = 已固定;! 红 = 连接异常。" We'll translate accordingly.

Let's continue.

4. Verwendung

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

Wenn der Port belegt ist, wird automatisch ein anderer verwendet. Details siehe Popup der Erweiterung („Verbunden · MCP-Port xxxx") oder ~/.browser-bridge/port.

Codex-Konfiguration (~/.codex/config.toml):

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

Danach kannst du der KI sagen: „Schau dir bitte diese Seite an …"

MCP-Tools

(table as above)

Steuerungsmodi

• Folgemodus (Standard): Steuert den aktuell aktiven Tab, Tab-Wechsel ändert das Ziel

• Fixierter Modus: Ein bestimmter Tab wird fixiert (folgt nicht mehr); über Popup oder browser_use_tab einstellen

Toolbar-Symbol-Badge: Grau = Folgemodus, AI Bernstein = fixiert, Rot = Verbindungsfehler.

Architektur

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

Konfiguration

• BROWSER_BRIDGE_PORT: MCP-Anfangsport (Standard: 0 = automatisch)

• BROWSER_BRIDGE_MOCK=1: Simulierte Erweiterungsantworten (nur für Tests)

Fehlerbehebung

Lizenz

MIT

Now we need to ensure we translated all. Also note the table at the top: we have some rows. Let's carefully translate the table.

Original table:

| 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_snapshot | — | 获取页面可交互元素快照(含坐标) | | browser_screenshot | — | 页面截图(视觉理解复杂布局) | | browser_click | ref | 点击元素 | | browser_dblclick | ref | 双击元素 | | browser_type | ref, text | 输入文本 | | browser_select | ref, value | 选择下拉框选项 | | browser_scroll | dir, amount? | 滚动 | | browser_hover | ref | 悬停 | | browser_highlight | ref | 高亮元素 1s(用户可见 AI 操作位置) | | browser_drag | fromRef, toRef | HTML5 拖拽 | | browser_goto | url | 导航到 URL | | browser_back | — | 后退 | | browser_refresh | — | 刷新页面 | | browser_wait | ms? | 等待页面稳定 |

We need to translate the descriptions.

We'll do that.

Also, the text after the table: "AI 自行编排:...".

Let's craft the full translation.

We need to preserve code blocks exactly. The placeholders GXP1, GXP2, GXP3, GXP4 are probably for code snippets. We should leave them as is Special: We have GXP1 and GXP2 in "### 3. Install the host" sectionorp; GXP3 and GXP4 in "### 4. Use" section. Also later "GXP5" appears in the architecture section? Actually the original after the "Steuerungsmodi" section has "## Architektur" and then GXP5? Let's check the original text. The user provided:

...

控制模式

• 跟随模式(默认):控制你当前激活的标签页,切 tab 即切目标

• 固定模式:锁定某个标签页(切 tab 不跟随);popup 一键固定/取消,或 AI 调用 browser_use_tab

工具栏图标徽标:灰色=跟随,蓝色=固定,红色=连接异常。

架构

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

构建与开发

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

So we have placeholders GXP5 and GXP6. We need to keep them.

We'll translate the heading "架构" as "Architektur", "构建与开发" as "Build & Entwicklung" or similar.

Now let's produce the full translation.

We must be careful to preserve all Markdown elements, including horizontal rules? There is no horizontal rule except table. We'll produce.

Let's draft the whole German translation.

I'll now write the answer.# Browser Bridge

KI↔Browser-Steuerbrücke: Verwandle den Browser in ein MCP-Werkzeugset. Jeder MCP-Client (KI-Programm) kann über das standardisierte MCP-Protokoll Werkzeuge wie browser_snapshot / browser_click / browser_type aufrufen, um im echten Browser zu arbeiten.

• Unterstützt beliebige MCP-Clients: Claude, codex, eigene Agents

• Standardmäßig Follow-Modus: Die KI steuert automatisch den aktuell aktiven Tab, keine Konfiguration nötig

• Echter Browser, kein Headless: CAPTCHAs (werden dir angezeigt), Login-Sitzungen bleiben erhalten

1. Erweiterung laden

1. Öffne chrome://extensions

2. Aktiviere oben rechts den Entwicklermodus

3. Klicke auf „Entpackte Erweiterung laden“ und wähle das Verzeichnis <DIR>/browser-bridge

2. Host installieren

Führe auf macOS/Linux aus:

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

Windows:

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

Danach erkennt der Host die installierten Browser automatisch.

3. MCP-Client konfigurieren

Claude Desktop (claude_desktop_config.json):

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

codex (~/.codex/config.toml):

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

Danach kannst du der KI sagen: „Schau dir diese Seite an …“

MCP-Werkzeuge

Die KI orchestriert selbst: Snapshot → Aktion → erneut Snapshot, bis die Aufgabe erledigt ist.

Steuerungsmodi

• Follow-Modus (Standard): Steuert den aktuell aktiven Tab; Tab-Wechsel wechselt auch das Ziel.

• Fester Modus: Ein bestimmter Tab wird fixiert (Folgen deaktiviert); Umschalten per Popup oder browser_use_tab.

Toolbar‑Symbol-Badge: Grau = Follow, Blau = Fixiert, Rot = Verbindungsfehler.

Architektur

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

Build & Entwicklung

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