Browser Navigator MCP

Ein Model Context Protocol (MCP)-Server, der KI-Assistenten die volle Kontrolle über den Brave-Browser via CDP (Chrome DevTools Protocol) gibt. Entwickelt für OSINT-Recherchen, Social-Media-Crawling und allgemeine Web-Automatisierung.

Verbindet sich mit Ihrer bestehenden Brave-Instanz (oder startet eine neue), ohne Ihre Tabs anzufassen — es verbindet sich mit dem Browser, nicht mit einer geklonten Kopie.

Funktionen

• 🧭 Volle Browsersteuerung — navigieren, klicken, tippen, scrollen, hover, Screenshots, PDF-Export

• 🪟 Fenster- & Tab-Verwaltung — Fenster/Tabs auflisten, öffnen, wechseln und schließen

• 🔐 CAPTCHA-Erkennung — erkennt automatisch reCAPTCHA, hCaptcha, Cloudflare Turnstile & Challenges und wartet dann, bis der Mensch sie löst

• 🍪 Sitzungspersistenz — Cookies speichern/laden, um Anmeldungen zwischen Läufen aufrechtzuerhalten

• 🎥 Videosteuerung — Play/Pause/Spulen/Lautstärke auf jedem HTML5-Player (YouTube usw.)

• 🔍 Social-Suche — Suchen mit einem Tool über Google, X/Twitter, Instagram, Facebook, LinkedIn, TikTok, YouTube

• 🔧 Beliebiges JS — execute_js für alles andere (mit einem expliziten Bestätigungs-Flag)

• 🏥 Health-Check — Server- + Browser-Verbindungsstatus bestätigen

Anforderungen

• Node.js 20+

• Brave-Browser (an einem Standardpfad installiert, oder über BRAVE_PATH angeben)

• Kein Playwright-Browser-Download erforderlich — der Server steuert Brave direkt über CDP

Installation

git clone <your-repo-url>
cd brave-browser-mcp
npm install

Schnellstart

1. Brave mit dem Debug-Port starten

./launch-brave.sh

Dies startet Brave mit --remote-debugging-port=9222. Es beendet niemals eine bestehende Brave-Instanz — wenn Port 9222 bereits belegt ist, lässt es ihn in Ruhe.

Alternativ können Sie Brave manuell mit brave --remote-debugging-port=9222 starten. Wenn Brave bereits ohne Debug-Port läuft, fordert Sie das MCP auf, es zu schließen und erneut zu versuchen — es beendet Ihren laufenden Browser nicht für Sie.

2. Den Server starten

node index.js

Der Server spricht MCP über stdio. connect_brave verbindet sich automatisch mit der laufenden Brave-Instanz.

3. Als MCP-Server registrieren

Für opencode fügen Sie zu opencode.json hinzu:

{
  "mcp": {
    "browser-navigator": {
      "type": "local",
      "command": ["node", "index.js"],
      "cwd": "/absolute/path/to/brave-browser-mcp",
      "enabled": true
    }
  }
}

Für Claude Desktop fügen Sie zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "browser-navigator": {
      "command": "node",
      "args": ["/absolute/path/to/brave-browser-mcp/index.js"]
    }
  }
}

Tools

CAPTCHA-Behandlung

CAPTCHAs werden nach navigate / navigate_history automatisch erkannt und in get_page_info gemeldet. Wenn ein ungelöstes CAPTCHA gefunden wird, pausiert die Automatisierung und bittet den Benutzer, es im Browser zu lösen — dieses Tool kann (und wird) sie nicht umgehen.

Erkannte Typen: reCAPTCHA, hCaptcha, Cloudflare Turnstile, Cloudflare Challenge.

Sicherheitshinweise

• execute_js erfordert confirm=true und ist auf 5000 Zeichen / 50KB Ausgabe begrenzt.

• Screenshot- & Cookie-Pfade sind gegen Path Traversal bereinigt.

• Cookies werden mit 0o600-Berechtigungen gespeichert, Verzeichnisse mit 0o700.

• Der Server beendet niemals einen Browser, den er nicht gestartet hat.

• Siehe AUDIT.md für das vollständige Sicherheits- & Codequalitäts-Audit.

Tests

Die Testsuite steuert den Server über das echte MCP-stdio-Protokoll (erfordert Brave, das auf Port 9222 läuft):

node test.cjs

53 Assertions, die Navigation, CAPTCHA, Tabs, Fenster, Screenshots, Cookies, Video und Sicherheitshärtung abdecken.

Lizenz

PolyForm Noncommercial 1.0.0 — siehe LICENSE.

Kostenlos für jeden nichtkommerziellen Zweck nutzbar (privat, Forschung, Bildung, Hobby, gemeinnützige Organisationen, Regierung). Für kommerzielle Nutzung kontaktieren Sie bitte zuerst den Autor — bitte melden Sie sich, bevor Sie dieses Projekt kommerziell nutzen.