mcp-server-browserbase

Playwright Browserbase MCP-Server

Abdeckung

Das Model Context Protocol (MCP) ist ein offenes Protokoll, das die nahtlose Integration zwischen LLM-Anwendungen und externen Datenquellen und Tools ermöglicht. Ob Sie eine KI-gestützte IDE erstellen, eine Chat-Oberfläche optimieren oder benutzerdefinierte KI-Workflows erstellen – MCP bietet eine standardisierte Möglichkeit, LLMs mit dem benötigten Kontext zu verbinden.

So richten Sie MCP json ein

Sie können entweder unseren auf NPM gehosteten Server verwenden oder ihn vollständig lokal ausführen, indem Sie dieses Repo klonen.

Zur Ausführung auf NPM (empfohlen)

Gehen Sie in Ihr MCP-Konfigurations-JSON und fügen Sie den Browserbase-Server hinzu:

{
   "mcpServers": {
      "browserbase": {
         "command": "npx",
         "args" : ["@browserbasehq/mcp"],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

Das war’s! Laden Sie Ihren MCP-Client neu und Claude kann Browserbase verwenden.

So führen Sie es zu 100 % lokal aus:

# Clone the Repo 
git clone https://github.com/browserbase/mcp-server-browserbase.git

# Install the dependencies in the proper directory and build the project
cd browserbase
npm install && npm run build

Führen Sie dann den Server in Ihrer MCP-Konfigurations-JSON aus. Für die lokale Ausführung können wir STDIO oder Self-Hosting über SSE verwenden.

STDIO:

Fügen Sie Ihrer MCP-Konfigurations-JSON-Datei Folgendes hinzu:

{
"mcpServers": {
   "browserbase": {
      "command" : "node",
      "args" : ["/path/to/mcp-server-browserbase/browserbase/cli.js"],
      "env": {
         "BROWSERBASE_API_KEY": "",
         "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

SSE:

Führen Sie den folgenden Befehl in Ihrem Terminal aus. Sie können beliebige Flags hinzufügen (siehe Optionen unten), um Ihre Konfiguration anzupassen.

   node cli.js --port 8931

Fügen Sie dann Folgendes in Ihre MCP-Konfigurations-JSON-Datei ein:

   {
      "mcpServers": {
         "browserbase": {
            "url": "http://localhost:8931/sse",
            "env": {
               "BROWSERBASE_API_KEY": "",
               "BROWSERBASE_PROJECT_ID": ""
            }
         }
      }
   }

Laden Sie dann Ihren MCP-Client neu und schon kann es losgehen!

Erklärung der Flaggen:

Der Browserbase MCP-Server akzeptiert die folgenden Befehlszeilenflags:

Flagge	Beschreibung
`--browserbaseApiKey <key>`	Ihr Browserbase-API-Schlüssel zur Authentifizierung
`--browserbaseProjectId <id>`	Ihre Browserbase-Projekt-ID
`--proxies`	Browserbase-Proxys für die Sitzung aktivieren
`--advancedStealth`	Browserbase Advanced Stealth aktivieren (Nur für Scale-Plan-Benutzer)
`--contextId <contextId>`	Geben Sie eine zu verwendende Browserbase-Kontext-ID an
`--persist [boolean]`	Ob der Browserbase-Kontext beibehalten werden soll (Standard: true)
`--port <port>`	Port zum Abhören des HTTP/SSE-Transports
`--host <host>`	Host, an den der Server gebunden werden soll (Standard: localhost, verwenden Sie 0.0.0.0 für alle Schnittstellen)
`--cookies [json]`	JSON-Array von Cookies zum Einfügen in den Browser
`--browserWidth <width>`	Breite des Browser-Ansichtsfensters (Standard: 1024)
`--browserHeight <height>`	Höhe des Browser-Ansichtsfensters (Standard: 768)

Diese Flags können direkt an die CLI übergeben oder in Ihrer MCP-Konfigurationsdatei konfiguriert werden.

NOTIZ:

Derzeit können diese Flags nur mit dem lokalen Server (npx @browserbasehq/mcp) verwendet werden.

Flags und Beispielkonfigurationen

Proxys

Hier sind unsere Dokumente zu Proxys .

Um Proxys in STDIO zu verwenden, setzen Sie das Flag --proxies in Ihrer MCP-Konfiguration:

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : ["@browserbasehq/mcp", "--proxies"],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

Erweiterte Tarnung

Hier sind unsere Dokumente zu Advanced Stealth .

Um Proxys in STDIO zu verwenden, setzen Sie das Flag --advancedStealth in Ihrer MCP-Konfiguration:

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : ["@browserbasehq/mcp", "--advancedStealth"],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

Kontexte

Hier sind unsere Dokumente zu Kontexten

Um Kontexte in STDIO zu verwenden, setzen Sie das Flag --contextId in Ihrer MCP-Konfiguration:

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : ["@browserbasehq/mcp", "--contextId", "<YOUR_CONTEXT_ID>"],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

Warum sollten Sie Cookies einfügen? Unsere Kontext-API arbeitet derzeit mit persistenten Cookies, aber nicht mit Sitzungscookies. Daher funktioniert unsere persistente Authentifizierung manchmal nicht (wir arbeiten mit Hochdruck an der Implementierung dieser Funktionalität).

Sie können Cookies im MCP markieren, indem Sie cookies.json zu Ihrer MCP-Konfiguration hinzufügen.

Um Proxys in STDIO zu verwenden, setzen Sie das Flag --proxies in Ihrer MCP-Konfiguration. Ihr Cookie-JSON muss im Typ Playwright Cookies vorliegen.

{
   "mcpServers": {
      "browserbase" {
         "command" : "npx",
         "args" : [
            "@browserbasehq/mcp", "--cookies", 
            '{
               "cookies": json,
            }'
         ],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

Browser-Ansichtsfenstergröße

Die Standard-Ansichtsfenstergröße für eine Browsersitzung beträgt 1024 x 768. Sie können die Größe des Browser-Ansichtsfensters mit den Flags „BrowserWidth“ und „BrowserHeight“ anpassen.

So verwenden Sie es für die benutzerdefinierte Browsergröße. Wir empfehlen, das Seitenverhältnis 16:9 beizubehalten (z. B. 1920 x 1080, 1280, 720, 1024 x 768).

{
   "mcpServers": {
      "browserbase": {
         "command" : "npx",
         "args" : [
            "@browserbasehq/mcp",
            "--browserHeight 1080",
            "--browserWidth 1920",
         ],
         "env": {
            "BROWSERBASE_API_KEY": "",
            "BROWSERBASE_PROJECT_ID": ""
         }
      }
   }
}

Struktur

src/ : TypeScript-Quellcode
- index.ts : Haupteinstiegspunkt, Umgebungsprüfungen, Herunterfahren
- server.ts : MCP-Server-Setup und Anforderungsrouting
- sessionManager.ts : Behandelt die Erstellung/Verwaltung von Browserbase-Sitzungen
- tools/ : Tooldefinitionen und -implementierungen
- resources/ : Ressourcenverwaltung (Screenshot)
- types.ts : Gemeinsam genutzte TypeScript-Typen
dist/ : Kompilierte JavaScript-Ausgabe
tests/ : Platzhalter für Tests
utils/ : Platzhalter für Dienstprogrammskripte
Dockerfile : Zum Erstellen eines Docker-Images
Konfigurationsdateien ( .json , .ts , .mjs , .npmignore )

Kontexte für Persistenz

Dieser Server unterstützt die Kontextfunktion von Browserbase, die das dauerhafte Speichern von Cookies, Authentifizierung und zwischengespeicherten Daten über Browsersitzungen hinweg ermöglicht:

Erstellen eines Kontexts :
browserbase_context_create: Creates a new context, optionally with a friendly name
Verwenden eines Kontexts mit einer Sitzung :
browserbase_session_create: Now accepts a 'context' parameter with: - id: The context ID to use - name: Alternative to ID, the friendly name of the context - persist: Whether to save changes (cookies, cache) back to the context (default: true)
Löschen eines Kontexts :
browserbase_context_delete: Deletes a context when you no longer need it

Kontexte machen es viel einfacher:

Anmeldestatus über Sitzungen hinweg beibehalten
Reduzieren Sie die Seitenladezeiten, indem Sie den Cache beibehalten
Vermeiden Sie CAPTCHAs und Erkennung durch die Wiederverwendung von Browser-Fingerabdrücken

Dieser Server bietet auch direkte Cookie-Verwaltungsfunktionen:

Hinzufügen von Cookies :
browserbase_cookies_add: Add cookies to the current browser session with full control over properties
Cookies erhalten :
browserbase_cookies_get: View all cookies in the current session (optionally filtered by URLs)
Cookies löschen :
browserbase_cookies_delete: Delete specific cookies or clear all cookies from the session

Diese Tools sind nützlich für:

Festlegen von Authentifizierungscookies ohne Navigieren zu Anmeldeseiten
Sichern und Wiederherstellen des Cookie-Status
Debuggen von Cookie-bezogenen Problemen
Manipulation von Cookie-Attributen (Ablauf, Sicherheitsflags usw.)

Aufgaben/Fahrplan

Implementieren Sie eine echte ref -basierte Interaktionslogik für Klicken, Eingeben, Ziehen, Hovern und Auswahloption.
Implementieren Sie elementspezifische Screenshots mithilfe von ref .
Fügen Sie weitere Standard-MCP-Tools hinzu (Registerkarten, Navigation usw.).
Tests hinzufügen.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Dieser Server bietet Cloud-Browser-Automatisierungsfunktionen mit Browserbase, Puppeteer und Stagehand. Er ermöglicht LLMs die Interaktion mit Webseiten, das Erstellen von Screenshots und die Ausführung von JavaScript in einer Cloud-Browserumgebung.

Related MCP Servers

Playwright MCP Server
lebrodus
A
security
F
license
A
quality
A server that enables browser automation using Playwright, allowing interaction with web pages, capturing screenshots, and executing JavaScript in a browser environment through LLMs.
Last updated -
12
10,534
1
TypeScript
Puppeteer MCP Server
jwaldor
A
security
F
license
A
quality
Enables LLMs to perform web browsing tasks, take screenshots, and execute JavaScript using Puppeteer for browser automation.
Last updated -
4
15,502
1
JavaScript
MCP Puppeteer Linux Server
PhialsBasement
A
security
F
license
A
quality
Enables browser automation for LLMs on Linux display servers, supporting web interaction, screenshots, and JavaScript execution in a real browser.
Last updated -
7
5
4
JavaScript
Steel Puppeteer
rdvo
-
security
A
license
-
quality
A Model Context Protocol server that enables LLMs to automate web browsers using Puppeteer, allowing navigation, screenshots, form filling, and JavaScript execution in a real browser environment.
Last updated -
JavaScript
MIT License

View all related MCP servers

mcp-server-browserbase

Playwright Browserbase MCP-Server

So richten Sie MCP json ein

Zur Ausführung auf NPM (empfohlen)

So führen Sie es zu 100 % lokal aus:

STDIO:

SSE:

Erklärung der Flaggen:

NOTIZ:

Flags und Beispielkonfigurationen

Proxys

Erweiterte Tarnung

Kontexte

Browser-Ansichtsfenstergröße

Struktur

Kontexte für Persistenz

Aufgaben/Fahrplan

Tools

Related MCP Servers

Playwright MCP Server

Puppeteer MCP Server

MCP Puppeteer Linux Server

Steel Puppeteer

Appeared in Searches

New MCP Servers

MCP directory API

Playwright Browserbase MCP-Server

So richten Sie MCP json ein

Zur Ausführung auf NPM (empfohlen)

So führen Sie es zu 100 % lokal aus:

STDIO:

SSE:

Erklärung der Flaggen:

NOTIZ:

Flags und Beispielkonfigurationen

Proxys

Erweiterte Tarnung

Kontexte

Cookie-Injektion

Browser-Ansichtsfenstergröße

Struktur

Kontexte für Persistenz

Cookie-Verwaltung

Aufgaben/Fahrplan

Tools

Related MCP Servers

Playwright MCP Server

Puppeteer MCP Server

MCP Puppeteer Linux Server

Steel Puppeteer

Appeared in Searches

New MCP Servers

MCP directory API