Browserbase

Browserbase MCP-Server

Archiviert

Dieses Repository ist archiviert und wird nicht mehr gewartet.

Es wurde ursprünglich als Referenzimplementierung veröffentlicht und wird zu historischen Zwecken aufbewahrt. Es sollte nicht als repräsentativ für die aktuellen Produktionsdienste oder die Implementierung von Browserbase interpretiert werden.

Das Model Context Protocol (MCP) ist ein offenes Protokoll, das eine nahtlose Integration zwischen LLM-Anwendungen und externen Datenquellen und Werkzeugen ermöglicht. Egal, ob Sie eine KI-gestützte IDE entwickeln, eine Chat-Schnittstelle erweitern oder benutzerdefinierte KI-Workflows erstellen, MCP bietet eine standardisierte Möglichkeit, LLMs mit dem benötigten Kontext zu verbinden.

Dieser Server bietet Cloud-Browser-Automatisierungsfunktionen unter Verwendung von Browserbase und Stagehand. Er ermöglicht es LLMs, mit Webseiten zu interagieren, Informationen zu extrahieren und automatisierte Aktionen durchzuführen.

Dies ist eine selbst hostbare Version des von Browserbase gehosteten MCP-Servers mit denselben Werkzeugen und Funktionen. Wir empfehlen die Verwendung der gehosteten Version für den einfachsten Einstieg.

Werkzeuge

Dieser Server stellt 6 Werkzeuge bereit, die mit dem gehosteten Browserbase MCP-Server übereinstimmen:

Werkzeug	Beschreibung	Eingabe
start	Eine Browserbase-Sitzung erstellen oder wiederverwenden	(keine)
end	Die aktuelle Browserbase-Sitzung schließen	(keine)
navigate	Zu einer URL navigieren	{ url: string }
act	Eine Aktion auf der Seite ausführen	{ action: string }
observe	Umsetzbare Elemente auf der Seite beobachten	{ instruction: string }
extract	Daten von der Seite extrahieren	{ instruction?: string }

Einrichtung

Wir unterstützen derzeit 2 Transportarten für unseren MCP-Server, STDIO und SHTTP. Wir empfehlen die Verwendung von SHTTP mit unserem gehosteten MCP-Server, um die volle Kapazität des Servers zu nutzen.

SHTTP (Gehostetes MCP):

Verwenden Sie den von Browserbase gehosteten MCP-Server unter https://mcp.browserbase.com/mcp. Dies ist der einfachste Einstieg – wir hosten den Server und übernehmen die LLM-Kosten für Gemini, das leistungsstärkste Modell in Stagehand.

Vollständige Einrichtungsanweisungen finden Sie in der Browserbase MCP-Dokumentation.

Wenn Ihr Client SHTTP unterstützt:

{
  "mcpServers": {
    "browserbase": {
      "type": "http",
      "url": "https://mcp.browserbase.com/mcp"
    }
  }
}

Wenn Ihr Client SHTTP nicht unterstützt:

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.browserbase.com/mcp"]
    }
  }
}

STDIO (Selbst gehostet):

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

Hinweis: Wenn Sie ein anderes Modell verwenden möchten, müssen Sie --modelName zu den Argumenten hinzufügen und den entsprechenden Schlüssel als Argument angeben. Weitere Informationen unten.

Ausführung über NPM (Empfohlen)

Gehen Sie zu Ihrer 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": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

Das war's! Laden Sie Ihren MCP-Client neu und Sie können loslegen.

100% lokale Ausführung:

Option 1: Direkte Installation

git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
npm install && npm run build

Option 2: Docker

git clone https://github.com/browserbase/mcp-server-browserbase.git
cd mcp-server-browserbase
docker build -t mcp-browserbase .

Führen Sie dann den Server in Ihrer MCP-Konfigurations-JSON aus:

Bei direkter Installation

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

Bei Verwendung von Docker

{
  "mcpServers": {
    "browserbase": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "BROWSERBASE_API_KEY",
        "-e",
        "BROWSERBASE_PROJECT_ID",
        "-e",
        "GEMINI_API_KEY",
        "mcp-browserbase"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": "",
        "GEMINI_API_KEY": ""
      }
    }
  }
}

Konfiguration

Der Browserbase MCP-Server akzeptiert die folgenden Befehlszeilen-Flags:

Flag	Beschreibung
--proxies	Browserbase-Proxys für die Sitzung aktivieren
--verified	Browserbase Verified Identity aktivieren (Nur für Benutzer des Scale-Tarifs)
--advancedStealth	Veralteter Alias für --verified
--keepAlive	Browserbase Keep Alive Session aktivieren
--contextId <contextId>	Eine zu verwendende Browserbase-Kontext-ID angeben
--persist	Ob der Browserbase-Kontext beibehalten werden soll (Standard: true)
--port <port>	Port, der auf HTTP/SHTTP-Transport lauschen soll
--host <host>	Host, an den der Server gebunden wird (Standard: localhost, 0.0.0.0 für alle Schnittstellen verwenden)
--browserWidth <width>	Breite des Browser-Viewports (Standard: 1024)
--browserHeight <height>	Höhe des Browser-Viewports (Standard: 768)
--modelName <model>	Das für Stagehand zu verwendende Modell (Standard: google/gemini-2.5-flash-lite)
--modelApiKey <key>	API-Schlüssel für den benutzerdefinierten Modellanbieter (erforderlich bei Verwendung benutzerdefinierter Modelle)
--experimental	Experimentelle Funktionen aktivieren (Standard: false)

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

Hinweis: Diese Flags können nur mit dem selbst gehosteten Server (npx @browserbasehq/mcp oder Docker) verwendet werden.

Modellkonfiguration

Stagehand verwendet standardmäßig das Gemini 2.5 Flash Lite-Modell von Google, aber Sie können es für die Verwendung anderer Modelle wie GPT-4o, Claude oder anderer Anbieter konfigurieren.

Wichtig: Wenn Sie ein benutzerdefiniertes Modell (nicht das Standardmodell) verwenden, müssen Sie Ihren eigenen API-Schlüssel für diesen Modellanbieter mit dem Flag --modelApiKey angeben.

{
  "mcpServers": {
    "browserbase": {
      "command": "npx",
      "args": [
        "@browserbasehq/mcp",
        "--modelName",
        "anthropic/claude-sonnet-4.5",
        "--modelApiKey",
        "your-anthropic-api-key"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": ""
      }
    }
  }
}

Hinweis: Das Modell muss in Stagehand unterstützt werden. Lesen Sie die Dokumentation hier.

Links

• Browserbase MCP-Dokumentation
• MCP-Dokumentation
• MCP-Spezifikation
• Stagehand-Dokumentation

Lizenz

Lizenziert unter der Apache 2.0 Lizenz.

Copyright 2025 Browserbase, Inc.