Browserbase

Serveur MCP Browserbase

Archivé

Ce dépôt est archivé et n'est plus maintenu.

Il a été publié à l'origine comme une implémentation de référence et est conservé à des fins historiques. Il ne doit pas être interprété comme représentatif des services ou de l'implémentation de production actuels de Browserbase.

Le Model Context Protocol (MCP) est un protocole ouvert qui permet une intégration transparente entre les applications LLM et les sources de données et outils externes. Que vous construisiez un IDE alimenté par IA, amélioriez une interface de chat ou créiez des flux de travail IA personnalisés, MCP fournit un moyen standardisé de connecter les LLM au contexte dont ils ont besoin.

Ce serveur fournit des capacités d'automatisation de navigateur dans le cloud en utilisant Browserbase et Stagehand. Il permet aux LLM d'interagir avec des pages web, d'extraire des informations et d'effectuer des actions automatisées.

Ceci est une version auto-hébergeable du serveur MCP hébergé par Browserbase avec les mêmes outils et fonctionnalités. Nous recommandons d'utiliser la version hébergée pour une configuration plus facile.

Outils

Ce serveur expose 6 outils qui correspondent au serveur MCP hébergé par Browserbase :

Outil	Description	Entrée
start	Créer ou réutiliser une session Browserbase	(aucune)
end	Fermer la session Browserbase actuelle	(aucune)
navigate	Naviguer vers une URL	{ url: string }
act	Effectuer une action sur la page	{ action: string }
observe	Observer les éléments actionnables sur la page	{ instruction: string }
extract	Extraire des données de la page	{ instruction?: string }

Comment configurer

Nous prenons actuellement en charge 2 transports pour notre serveur MCP, STDIO et SHTTP. Nous vous recommandons d'utiliser SHTTP avec notre serveur MCP hébergé pour profiter pleinement des capacités du serveur.

SHTTP (MCP hébergé) :

Utilisez le serveur MCP hébergé par Browserbase à l'adresse https://mcp.browserbase.com/mcp. C'est le moyen le plus simple de commencer -- nous hébergeons le serveur et fournissons les coûts LLM pour Gemini, le modèle le plus performant dans Stagehand.

Pour des instructions de configuration complètes, consultez la documentation MCP de Browserbase.

Si votre client prend en charge SHTTP :

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

Si votre client ne prend pas en charge SHTTP :

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

STDIO (Auto-hébergé) :

Vous pouvez soit utiliser notre serveur hébergé sur NPM, soit l'exécuter entièrement en local en clonant ce dépôt.

Remarque : Si vous souhaitez utiliser un modèle différent, vous devez ajouter --modelName aux arguments et fournir la clé correspondante en tant qu'argument. Plus d'informations ci-dessous.

Pour exécuter via NPM (Recommandé)

Allez dans votre JSON de configuration MCP et ajoutez le serveur Browserbase :

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

C'est tout ! Rechargez votre client MCP et vous êtes prêt à démarrer.

Pour exécuter 100% en local :

Option 1 : Installation directe

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 .

Ensuite, dans votre JSON de configuration MCP, exécutez le serveur :

Utilisation de l'installation directe

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

Utilisation de 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": ""
      }
    }
  }
}

Configuration

Le serveur MCP Browserbase accepte les indicateurs de ligne de commande suivants :

Indicateur	Description
--proxies	Activer les proxys Browserbase pour la session
--verified	Activer l'identité vérifiée Browserbase (uniquement pour les utilisateurs du forfait Scale)
--advancedStealth	Alias obsolète pour --verified
--keepAlive	Activer la session Keep Alive de Browserbase
--contextId <contextId>	Spécifier un ID de contexte Browserbase à utiliser
--persist	S'il faut persister le contexte Browserbase (par défaut : true)
--port <port>	Port d'écoute pour le transport HTTP/SHTTP
--host <host>	Hôte auquel lier le serveur (par défaut : localhost, utiliser 0.0.0.0 pour toutes les interfaces)
--browserWidth <width>	Largeur de la fenêtre d'affichage du navigateur (par défaut : 1024)
--browserHeight <height>	Hauteur de la fenêtre d'affichage du navigateur (par défaut : 768)
--modelName <model>	Le modèle à utiliser pour Stagehand (par défaut : google/gemini-2.5-flash-lite)
--modelApiKey <key>	Clé API pour le fournisseur de modèle personnalisé (requis lors de l'utilisation de modèles personnalisés)
--experimental	Activer les fonctionnalités expérimentales (par défaut : false)

Ces indicateurs peuvent être passés directement à la CLI ou configurés dans votre fichier de configuration MCP.

Remarque : Ces indicateurs ne peuvent être utilisés qu'avec le serveur auto-hébergé (npx @browserbasehq/mcp ou Docker).

Configuration du modèle

Stagehand utilise par défaut le modèle Gemini 2.5 Flash Lite de Google, mais vous pouvez le configurer pour utiliser d'autres modèles comme GPT-4o, Claude ou d'autres fournisseurs.

Important : Lorsque vous utilisez un modèle personnalisé (non par défaut), vous devez fournir votre propre clé API pour ce fournisseur de modèle en utilisant l'indicateur --modelApiKey.

{
  "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": ""
      }
    }
  }
}

Remarque : Le modèle doit être pris en charge dans Stagehand. Consultez la documentation ici.

Liens

• Documentation MCP de Browserbase
• Documentation MCP
• Spécification MCP
• Documentation Stagehand

Licence

Sous licence Apache 2.0.

Copyright 2025 Browserbase, Inc.