Better AI Browser Utilities (BABU)

Token-effiziente MCP-Steuerung für die Chrome-Sitzung, die Sie bereits nutzen – Tabs, Cookies, Anmeldungen und alles Weitere. BABU verbindet jeden MCP-kompatiblen Codierungsagenten mit einer lokalen Chrome-Erweiterung, anstatt ein separates Automatisierungsprofil zu starten.

Warum BABU

• Vier kompakte MCP-Schemas standardmäßig statt zwanzig sich wiederholender Browser-Tools.

• Progressive Offenlegung: browser_read gibt begrenzten Text und kompakte Steuerelemente zurück; browser_help zeigt Befehlsdetails nur auf Anfrage an.

• Schnelle Aktionen: browser_do steuert Navigation, Klicks, Tippen, Tasten, Scrollen, Warten, Screenshots, JavaScript und Loopback-Dateiuploads.

• Echter Browserzustand: nutzt Ihre vorhandenen Chrome-Tabs und authentifizierten Sitzungen.

• Tragbar: direkt von GitHub mit uvx installierbar; jeder dokumentierte Client verwendet standardmäßiges MCP-Studio.

• Lokal zuerst: Der einzige Netzwerk-Listener bindet an 127.0.0.1; die Erweiterungs-WebSocket-Verbindung erfordert ein generiertes Pairing-Token.

Die veröffentlichten MCP-v2-Schemas messen 567 Token im kompakten Modus gegenüber 2.219 für die alte Oberfläche mit zwanzig Tools: 74,45 % weniger Schema-Kontext pro Modellrunde (o200k_base, kanonisches JSON, ohne Client-Framing).

Architektur

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

Installation

Voraussetzungen: uv und Chrome 116 oder neuer.

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

Der Befehl exportiert die gebündelte Erweiterung nach ~/.babu/extension, erstellt ~/.babu/token und gibt das Token einmalig zum Pairing aus.

In Chrome:

1. Öffnen Sie chrome://extensions.

2. Aktivieren Sie den Entwicklermodus.

3. Wählen Sie Entpackte Erweiterung laden und wählen Sie das gedruckte Erweiterungsverzeichnis.

4. Öffnen Sie die BABU-Erweiterung, fügen Sie das Pairing-Token ein und wählen Sie Speichern.

Stabiles Chrome akzeptiert keine automatisierte --load-extension-Installation mehr, daher ist das einmalige manuelle Laden erforderlich.

BABU zu einem MCP-Client hinzufügen

Verwenden Sie diese Stdio-Startdefinition:

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

Genaue Befehle und Konfigurationsdateien für Hermes, Codex, Claude Code, Cursor, VS Code, Zed, ZCode, Gemini CLI, OpenCode, Cline, Windsurf, Pi und Agent Prime finden Sie in docs/CLIENTS.md.

Nur ein BABU-Prozess kann den WebSocket-Port 8765 gleichzeitig belegen. Schließen Sie eine andere BABU-fähige Umgebung, bevor Sie eine neue starten.

MCP-Tools

browser_do-Befehle:

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

Empfohlener Ablauf:

1. Rufen Sie browser_read mit einer relevanten query auf.

2. Übergeben Sie den zurückgegebenen Elementindex an browser_do mit click oder type.

3. Lesen Sie nach der Navigation oder größeren DOM-Änderungen erneut, da Indizes dokumentlokal sind.

4. Verwenden Sie browser_help nur, wenn die Parameter eines Befehls unklar sind.

Screenshots werden standardmäßig im temporären Systemverzeichnis gespeichert; Base64-Bildbytes werden aus dem Modellkontext weggelassen, sofern nicht include_data_url=true explizit angegeben ist.

CLI-Dienstprogramme

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 ist nützlich für minimale Umgebungen, die CLI-Tools gegenüber MCP bevorzugen.

Tool-Profile

• compact (Standard): die vier oben genannten Tools.

• legacy: zwanzig direkte Browser-Tools für Clients, die ein Schema pro Aktion bevorzugen.

• all: beide Oberflächen.

Wählen Sie ein Profil mit --tool-profile compact|legacy|all oder BABU_TOOL_PROFILE.

Sicherheit

BABU steuert das angemeldete Browserprofil. Behandeln Sie es daher als leistungsfähiges lokales Tool.

• Der WebSocket-Listener bindet nur an 127.0.0.1; MCP läuft über stdio.

• Ursprünge der Chrome-Erweiterung und Client-Rollen werden validiert.

• Der Kanal zwischen Erweiterung und Brücke verwendet ein 256-Bit-Token, das unter ~/.babu/token gespeichert ist.

• Das Erweiterungs-Popup kann die gesamte Steuerung sofort deaktivieren.

• Passwort-, OTP- und Zahlungsfelder werden bei Routine-Lesezugriffen geschwärzt.

• browser_eval führt JavaScript im Hauptkontext der Seite aus – wie vorgesehen.

• Datei-Upload akzeptiert nur begrenzte direkte Loopback-HTTP(S)-URLs ohne Anmeldeinformationen.

Überprüfen Sie jeden MCP-Toolaufruf und nutzen Sie die Genehmigungssteuerung jedes Clients.

Einschränkungen

• Chrome-interne Seiten, der Web Store, der PDF-Viewer, entladene Tabs und Steuerelemente in Iframes oder Shadow-Roots können nicht gesteuert werden.

• Strenge Seiten-CSP kann browser_eval blockieren; DOM-Lese-/Klick-/Eingabe-Tools funktionieren weiterhin.

• browser_press unterstützt Enter, Tab und synthetisches Escape; verwenden Sie browser_type für Text.

• Die entpackte Erweiterung muss nach einem Update über chrome://extensions neu geladen werden.

• Der Server ist standardmäßig für einen einzelnen Client und eine einzelne Browsererweiterung ausgelegt.

Aktualisieren

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

Laden Sie BABU unter chrome://extensions neu und starten Sie dann den MCP-Client neu. Ändern Sie den Git-Tag in Ihrer Client-Konfiguration, wenn Sie eine neuere Version übernehmen.

Lizenz

MIT