base de navegador del servidor mcp

Servidor MCP de Playwright Browserbase

cubrir

El Protocolo de Contexto de Modelo (MCP) es un protocolo abierto que permite una integración fluida entre las aplicaciones LLM y las fuentes de datos y herramientas externas. Ya sea que esté creando un IDE basado en IA, mejorando una interfaz de chat o creando flujos de trabajo de IA personalizados, MCP proporciona una forma estandarizada de conectar las aplicaciones LLM con el contexto que necesitan.

Cómo configurar en MCP json

Puede utilizar nuestro servidor alojado en NPM o ejecutarlo completamente localmente clonando este repositorio.

Para ejecutar en NPM (recomendado)

Vaya a su JSON de configuración de MCP y agregue el servidor Browserbase:

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

¡Listo! Recarga tu cliente MCP y Claude podrá usar Browserbase.

Para ejecutar 100% local:

# 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

Luego, en el JSON de configuración de MCP, ejecute el servidor. Para ejecutarlo localmente, podemos usar STDIO o alojarlo en nuestro propio servidor SSE.

ESTUDIO:

A su archivo JSON de configuración de MCP agregue lo siguiente:

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

SSE:

Ejecute el siguiente comando en su terminal. Puede agregar las opciones que considere necesarias (vea las opciones a continuación) para personalizar su configuración.

   node cli.js --port 8931

Luego, en su archivo JSON de configuración MCP, coloque lo siguiente:

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

Luego vuelve a cargar tu cliente MCP ¡y estarás listo!

Banderas explicadas:

El servidor MCP de Browserbase acepta los siguientes indicadores de línea de comandos:

Bandera	Descripción
`--browserbaseApiKey <key>`	Su clave API de Browserbase para autenticación
`--browserbaseProjectId <id>`	Su ID de proyecto de Browserbase
`--proxies`	Habilitar los proxies de Browserbase para la sesión
`--advancedStealth`	Habilitar Browserbase Advanced Stealth (solo para usuarios del plan Scale)
`--contextId <contextId>`	Especifique un ID de contexto de Browserbase para usar
`--persist [boolean]`	Si se debe conservar el contexto de Browserbase (valor predeterminado: verdadero)
`--port <port>`	Puerto para escuchar el transporte HTTP/SSE
`--host <host>`	Host al que vincular el servidor (predeterminado: localhost, use 0.0.0.0 para todas las interfaces)
`--cookies [json]`	Matriz JSON de cookies para inyectar en el navegador
`--browserWidth <width>`	Ancho de la ventana gráfica del navegador (predeterminado: 1024)
`--browserHeight <height>`	Altura de la ventana gráfica del navegador (valor predeterminado: 768)

Estas banderas pueden pasarse directamente a la CLI o configurarse en el archivo de configuración de MCP.

NOTA:

Actualmente, estas banderas sólo se pueden usar con el servidor local (npx @browserbasehq/mcp).

Banderas y configuraciones de ejemplo

Proxies

Aquí están nuestros documentos sobre Proxies .

Para usar proxies en STDIO, configure el indicador --proxies en su configuración MCP:

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

Sigilo avanzado

Aquí están nuestros documentos sobre Advanced Stealth .

Para usar proxies en STDIO, configure el indicador --advancedStealth en su configuración MCP:

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

Contextos

Aquí están nuestros documentos sobre Contextos

Para usar contextos en STDIO, configure el indicador --contextId en su configuración MCP:

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

Inyección de galletas

¿Por qué necesitarías inyectar cookies? Nuestra API de contexto actualmente funciona con cookies persistentes, pero no con cookies de sesión. Por lo tanto, a veces nuestra autenticación persistente podría no funcionar (estamos trabajando arduamente para agregar esta funcionalidad).

Puede marcar las cookies en el MCP agregando cookies.json a su configuración de MCP.

Para usar proxies en STDIO, configure el parámetro --proxies en la configuración de MCP. El JSON de sus cookies debe ser del tipo Playwright Cookies.

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

Tamaño de la ventana gráfica del navegador

El tamaño de la ventana gráfica predeterminado para una sesión de navegador es 1024 x 768. Puede ajustar el tamaño de la ventana gráfica del navegador con los indicadores browserWidth y browserHeight.

Aquí te explicamos cómo usarla para personalizar el tamaño del navegador. Recomendamos usar relaciones de aspecto 16:9 (p. ej.: 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": ""
         }
      }
   }
}

Estructura

src/ : Código fuente de TypeScript
- index.ts : Punto de entrada principal, comprobaciones de entorno, apagado
- server.ts : Configuración del servidor MCP y enrutamiento de solicitudes
- sessionManager.ts : gestiona la creación y gestión de sesiones de Browserbase
- tools/ : Definiciones e implementaciones de herramientas
- resources/ : Manejo de recursos (captura de pantalla)
- types.ts : Tipos de TypeScript compartidos
dist/ : Salida de JavaScript compilada
tests/ : Marcador de posición para pruebas
utils/ : Marcador de posición para scripts de utilidad
Dockerfile : para crear una imagen de Docker
Archivos de configuración ( .json , .ts , .mjs , .npmignore )

Contextos para la persistencia

Este servidor admite la función Contextos de Browserbase, que permite conservar cookies, autenticación y datos almacenados en caché en las sesiones del navegador:

Creando un contexto :
browserbase_context_create: Creates a new context, optionally with a friendly name
Usando un contexto con una sesión :
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)
Eliminar un contexto :
browserbase_context_delete: Deletes a context when you no longer need it

Los contextos hacen que sea mucho más fácil:

Mantener el estado de inicio de sesión en todas las sesiones
Reducir los tiempos de carga de la página preservando el caché
Evite los CAPTCHA y la detección reutilizando las huellas dactilares del navegador

Gestión de cookies

Este servidor también proporciona capacidades de gestión directa de cookies:

Añadiendo cookies :
browserbase_cookies_add: Add cookies to the current browser session with full control over properties
Obtener cookies :
browserbase_cookies_get: View all cookies in the current session (optionally filtered by URLs)
Eliminar cookies :
browserbase_cookies_delete: Delete specific cookies or clear all cookies from the session

Estas herramientas son útiles para:

Configuración de cookies de autenticación sin navegar a las páginas de inicio de sesión
Realizar copias de seguridad y restaurar el estado de las cookies
Depuración de problemas relacionados con las cookies
Manipular atributos de cookies (caducidad, indicadores de seguridad, etc.)

TODO/Hoja de ruta

Implemente una verdadera lógica de interacción basada en ref para hacer clic, escribir, arrastrar, pasar el mouse y seleccionar opciones.
Implemente capturas de pantalla específicas de elementos usando ref .
Agregue más herramientas MCP estándar (pestañas, navegación, etc.).
Añadir pruebas.

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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

Este servidor proporciona capacidades de automatización de navegadores en la nube mediante Browserbase, Puppeteer y Stagehand. Permite a los LLM interactuar con páginas web, tomar capturas de pantalla y ejecutar JavaScript en un entorno de navegador en la nube.

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
9,457
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