Browserbase MCP Server

oficial

Automatize interações com navegador na nuvem (ex.: navegação web, extração de dados, preenchimento de formulários e mais)

GitHub

3.4k

Documentação

Servidor MCP do Browserbase

cover

O Model Context Protocol (MCP) é um protocolo aberto que permite integração perfeita entre aplicações LLM e fontes de dados e ferramentas externas. Seja você esteja construindo um IDE com IA, aprimorando uma interface de chat ou criando fluxos de trabalho de IA personalizados, o MCP fornece uma maneira padronizada de conectar LLMs ao contexto de que precisam.

Este servidor oferece recursos de automação de navegador na nuvem usando Browserbase e Stagehand. Ele permite que LLMs interajam com páginas da web, extraiam informações e realizem ações automatizadas.

Esta é uma versão auto-hospedável do servidor MCP hospedado do Browserbase com as mesmas ferramentas e funcionalidades. Recomendamos usar a versão hospedada para a configuração mais simples.

Ferramentas

Este servidor expõe 6 ferramentas que correspondem ao servidor MCP hospedado do Browserbase:

Ferramenta	Descrição	Entrada
`start`	Criar ou reutilizar uma sessão do Browserbase	(nenhuma)
`end`	Fechar a sessão atual do Browserbase	(nenhuma)
`navigate`	Navegar para uma URL	`{ url: string }`
`act`	Realizar uma ação na página	`{ action: string }`
`observe`	Observar elementos acionáveis na página	`{ instruction: string }`
`extract`	Extrair dados da página	`{ instruction?: string }`

Como Configurar

Atualmente, oferecemos suporte a 2 transportes para nosso servidor MCP, STDIO e SHTTP. Recomendamos usar SHTTP com nosso servidor MCP hospedado para aproveitar a capacidade total do servidor.

SHTTP (MCP Hospedado):

Use o servidor MCP hospedado do Browserbase em https://mcp.browserbase.com/mcp. Esta é a maneira mais fácil de começar -- nós hospedamos o servidor e fornecemos os custos de LLM para o Gemini, o modelo de melhor desempenho no Stagehand.

Para instruções completas de configuração, consulte a documentação do MCP do Browserbase.

Se seu cliente suporta SHTTP:

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

Se seu cliente não suporta SHTTP:

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

STDIO (Auto-Hospedado):

Você pode usar nosso servidor hospedado no NPM ou executá-lo completamente localmente clonando este repositório.

Nota: Se você quiser usar um modelo diferente, precisa adicionar --modelName aos argumentos e fornecer a chave respectiva como argumento. Mais informações abaixo.

Para executar via NPM (Recomendado)

Vá para o JSON de configuração do MCP e adicione o Servidor Browserbase:

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

É isso! Recarregue seu cliente MCP e você estará pronto para usar.

Para executar 100% local:

Opção 1: Instalação direta

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

Opção 2: Docker

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

Em seguida, no JSON de configuração do MCP, execute o servidor:

Usando Instalação Direta

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

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

Configuração

O servidor MCP do Browserbase aceita as seguintes flags de linha de comando:

Flag	Descrição
`--proxies`	Habilitar proxies do Browserbase para a sessão
`--verified`	Habilitar Identidade Verificada do Browserbase (Apenas para usuários do Plano Scale)
`--advancedStealth`	Alias obsoleto para `--verified`
`--keepAlive`	Habilitar Sessão Keep Alive do Browserbase
`--contextId <contextId>`	Especificar um ID de Contexto do Browserbase para usar
`--persist`	Se deve persistir o contexto do Browserbase (padrão: true)
`--port <port>`	Porta para escutar no transporte HTTP/SHTTP
`--host <host>`	Host para vincular o servidor (padrão: localhost, use 0.0.0.0 para todas as interfaces)
`--browserWidth <width>`	Largura da viewport do navegador (padrão: 1024)
`--browserHeight <height>`	Altura da viewport do navegador (padrão: 768)
`--modelName <model>`	O modelo a ser usado para o Stagehand (padrão: google/gemini-2.5-flash-lite)
`--modelApiKey <key>`	Chave de API para o provedor de modelo personalizado (obrigatório ao usar modelos personalizados)
`--experimental`	Habilitar recursos experimentais (padrão: false)

Essas flags podem ser passadas diretamente para a CLI ou configuradas no seu arquivo de configuração do MCP.

Nota: Essas flags só podem ser usadas com o servidor auto-hospedado (npx @browserbasehq/mcp ou Docker).

Configuração de Modelo

O Stagehand usa por padrão o modelo Gemini 2.5 Flash Lite do Google, mas você pode configurá-lo para usar outros modelos como GPT-4o, Claude ou outros provedores.

Importante: Ao usar qualquer modelo personalizado (não padrão), você deve fornecer sua própria chave de API para esse provedor de modelo usando a flag --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": ""
      }
    }
  }
}

Nota: O modelo deve ser suportado no Stagehand. Confira a documentação aqui.

Licença

Licenciado sob a Licença Apache 2.0.