Browserbase

Servidor MCP Browserbase

Arquivado

Este repositório está arquivado e não é mais mantido.

Ele foi originalmente publicado como uma implementação de referência e é mantido para fins históricos. Não deve ser interpretado como representativo dos serviços ou implementações de produção atuais da Browserbase.

O Protocolo de Contexto de Modelo (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 fornece 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 da Browserbase com as mesmas ferramentas e funcionalidades. Recomendamos usar a versão hospedada para a configuração mais fácil.

Ferramentas

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

Ferramenta	Descrição	Entrada
start	Criar ou reutilizar uma sessão 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 da 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 da 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, você deve adicionar --modelName aos argumentos e fornecer a chave respectiva como um 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 Browserbase aceita os seguintes sinalizadores de linha de comando:

Sinalizador	Descrição
--proxies	Habilitar proxies Browserbase para a sessão
--verified	Habilitar Identidade Verificada 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 Browserbase para usar
--persist	Se deve persistir o contexto 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 janela de visualização do navegador (padrão: 1024)
--browserHeight <height>	Altura da janela de visualização 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 API para o provedor de modelo personalizado (obrigatório ao usar modelos personalizados)
--experimental	Habilitar recursos experimentais (padrão: false)

Esses sinalizadores podem ser passados diretamente para a CLI ou configurados no seu arquivo de configuração MCP.

Nota: Esses sinalizadores só podem ser usados com o servidor auto-hospedado (npx @browserbasehq/mcp ou Docker).

Configuração do 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 API para esse provedor de modelo usando o sinalizador --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.

Links

• Documentação do MCP Browserbase
• Documentação do MCP
• Especificação do MCP
• Documentação do Stagehand

Licença

Licenciado sob a Licença Apache 2.0.

Copyright 2025 Browserbase, Inc.