Chrome Control MCP

Sichtbare, präzise Chrome-Steuerung für KI-Assistenten. Lokal konzipiert.

Schnellstart · Tool-Katalog · Architektur · Sicherheit · Verifizierung

Aktive Automatisierung bleibt sichtbar: Rosa Rahmen, AI CONTROL-Abzeichen und pulsierender Agent-Cursor zeigen an, wenn ein Assistent Chrome steuert. Modellseitige Screenshots blenden diese Überlagerung standardmäßig aus; Dokumentationsaufnahmen können sie optional einbeziehen.

Warum dieses Projekt

Alle 43 MCP-Tools verwenden strikte JSON-Schemas. Der langlebige MCP-Prozess bewahrt den Sitzungs- und Elementreferenzzustand, während Chrome ein gewöhnlicher, benutzergesteuerter Browser bleibt.

Related MCP server: Chrome MCP Server

In Aktion

Beide Bilder sind direkte browser_screenshot-Ergebnisse aus der Live-Erweiterung, keine Mockups.

Besonderer Dank für das Testen: Inflectras UI Test Automation Playground und das Open-Source-Repository bieten fokussierte, praxisnahe Browser-Interaktionsszenarien. Sie waren für das Testen des vollständigen MCP-zu-Chrome-Pfads dieses Projekts von unschätzbarem Wert.

Schnellstart

1. Installieren der Build-Anforderungen

• Windows 10/11 x64, Linux x64 oder macOS

• Google Chrome 116+

• CMake 3.25+

• Qt 6.5+ mit den Komponenten Core und Test

• C++20-Compiler: Visual Studio 2022, GCC oder Clang

• Node.js 20.19+

2. Build und Test

npm ci
npm run build

Standardausgabe:

PowerShell-Benutzer können stattdessen ./scripts/build.ps1 -Configuration Release ausführen. Beide Pfade bauen mit Warnings-as-Errors und führen alle nativen sowie Erweiterungs-Unit-Testsuiten aus.

3. Chrome vorbereiten

npm run extension -- install

Öffnen Sie chrome://extensions, aktivieren Sie den Entwicklermodus, wählen Sie Entpackte Erweiterung laden und anschließend den vom Befehl ausgegebenen Ordner. Chrome erfordert diesen einen manuellen Schritt für eine entpackte Erweiterung.

Es wird kein Signaturschlüssel, keine gepackte Erweiterung, kein Store-Konto, kein Administratorzugriff und keine Unternehmensrichtlinie benötigt. Der öffentliche key in manifest.json legt nur die ID der entpackten Erweiterung fest; er kann keine Software signieren.

4. Einen Assistenten verbinden

Verwenden Sie den absoluten Pfad der ausführbaren Datei.

# Windows
codex mcp add chrome-control -- "C:\absolute\path\chrome_control_mcp.exe"

# Linux / macOS
codex mcp add chrome-control -- /absolute/path/chrome_control_mcp

Claude Code verwendet dieselbe ausführbare Datei:

claude mcp add --scope local chrome-control -- /absolute/path/chrome_control_mcp

Der Transport ist zeilenweise getrennter JSON-RPC über stdio. Der Server öffnet keinen TCP-Listener.

Architektur

flowchart LR
    A[AI assistant] -->|MCP over stdio| B[chrome_control_mcp]
    B -->|Windows named pipe<br/>Linux/macOS Unix socket| C[Native-host relay]
    C -->|Chrome native messaging| D[Unpacked MV3 extension]
    D -->|Chrome DevTools Protocol| E[Active Chrome tab]

Eine einzige ausführbare Datei übernimmt sowohl die Rolle des MCP-Servers als auch die des Native-Host-Relays. Die Browsersteuerung gehört in den MCP, weil sie aufrufbare Tools, Bildergebnisse, gehärtete IPC und persistenten Sitzungszustand benötigt. Ein Skill kann Arbeitsabläufe hinzufügen, ersetzt den Server jedoch nicht.

Sicherheitsmodell

Volle Kontrolle ist mächtig. Chrome Control MCP fixiert den Erweiterungsursprung, begrenzt und validiert IPC, authentifiziert das Relay für denselben Benutzer/dieselbe ausführbare Datei, lehnt veraltete Elementreferenzen und Screenshot-Koordinaten ab, begrenzt große Nutzlasten und stellt strikte Schemas bereit.

Windows verwendet eine ACL-geschützte Named Pipe des aktuellen Benutzers. Linux und macOS verwenden einen Unix-Socket mit Modus 0600 im privaten Laufzeitverzeichnis sowie Betriebssystem-Peer-Anmeldeinformationen.

Für reine Inspektionszwecke:

CHROME_CONTROL_MCP_SECURITY_PROFILE=read_only
CHROME_CONTROL_MCP_REDACT_SENSITIVE_OUTPUT=true

Das schreibgeschützte Profil stellt 10 Tools bereit und lehnt versteckte mutierende Aufrufe unabhängig ab.

Verifizierung

Lokale Windows- und Linux-Gates decken derzeit Folgendes ab:

• 9/9 native Suiten und Erweiterungssuiten mit MSVC, GCC und Clang

• Warnings-as-Errors plus clang-tidy und ein umfassender cppcheck-Lauf

• Separate ASan+UBSan- und TSan-Läufe

• Gitleaks-Scan über den gesamten Verlauf und npm-Abhängigkeitsprüfung

• 43/43 Live-MCP-Tools durch echtes Chrome unter Windows

• Navigation im öffentlichen UI Playground, Snapshot, Tippen, Klick und PNG-Erfassung

• Reversibler Native-Host-Installations-/Status-/Deinstallations-Lebenszyklus

GitHub Actions erstellt und testet Windows, Linux und macOS bei jedem direkten Push.

npm run smoke
npm run smoke:read-only
node tests/e2e/full_browser_e2e.mjs

PowerShell-Live-Prüfung der öffentlichen Website:

./scripts/live_browser_verify.ps1 -Site http://uitestingplayground.com/

Genaue Belege und Anspruchsgrenzen ansehen.

Projektidentität

Melden Sie den Native-Host des aktuellen Benutzers mit npm run extension -- uninstall ab und entfernen Sie die entpackte Erweiterung anschließend manuell unter chrome://extensions, wenn Sie sie nicht mehr benötigen.

Lizenz

Veröffentlicht unter der MIT License. Copyright © 2026 Randy Northrup.