Browser Bridge

KI ↔ Browser-Steuerungsbrücke: Verwandelt den Browser in ein MCP-Toolset. Jeder MCP-Client (KI-Programm) kann über das Standard-MCP-Protokoll Tools wie browser_snapshot / browser_click / browser_type aufrufen, um Webseiten in einem echten Browser zu bedienen.

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

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

• Echter Browser, nicht headless: Login-Zustand, Captchas (werden dir zur manuellen Lösung angezeigt), Anti-Scraping-Merkmale natürlich

Schnellstart

1. Herunterladen

Lade ein Archiv von Releases herunter:

• browser-bridge-<platform>-<arch>.zip — wähle passend zur Plattform deines Rechners

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

2. Erweiterung laden

1. Öffne chrome://extensions

2. Aktiviere oben rechts den Entwicklermodus

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

3. Host installieren

macOS / Linux:

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

Nach dem Ausführen werden die erkannten Browser aufgelistet. Drücke Enter, um in alle zu installieren, oder gib eine Nummer ein, um einen bestimmten Browser auszuwählen. Auch die direkte Angabe per Parameter wird unterstützt:

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

Die Erweiterungs-ID ist fest eingebaut, keine manuelle Eingabe nötig. Falls deine Erweiterungs-ID abweicht, kannst du sie als Parameter anhängen: ./install-host.sh <deine-Erweiterungs-ID>.

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

4. Verwendung

Verbinde mit einem beliebigen MCP-Client:

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

Wenn der Port belegt ist, wird automatisch +1 gerechnet. Den tatsächlichen Port siehst du im Erweiterungs-Popup (Verbunden · MCP-Port xxxx) oder in ~/.browser-bridge/port.

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

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

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

Related MCP server: Playwright MCP Server

MCP-Tools

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

Steuerungsmodi

• Follow-Modus (Standard): Steuert deinen aktuell aktiven Tab; Tab-Wechsel = Zielwechsel

• Fixierter Modus: Sperrt einen bestimmten Tab (kein Follow bei Wechsel); im Popup per Klick fixieren/lösen, oder die KI ruft browser_use_tab auf

Symbol-Badge in der Symbolleiste: keine = Follow aktiv; AI amber = 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:快照 / 执行

MV3-Erweiterungen können keine Ports abhören; der native Host ist der einzige Kanal (gleich aufgebaut wie das offizielle Chrome-DevTools-MCP).

Aus dem Quellcode bauen (Entwickler)

Benötigt bun:

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

Konfiguration

• BROWSER_BRIDGE_PORT: MCP-Startport (Standard 1234, bei Belegung automatisch +1)

• BROWSER_BRIDGE_MOCK=1: Simuliert Erweiterungsantworten (für Entwicklung und Tests)

Fehlerbehebung

Lizenz

MIT