Chrome MCP Server

Chrome MCP Server

Um servidor Model Context Protocol (MCP) que fornece controle detalhado sobre uma instância do navegador Chrome por meio do Chrome DevTools Protocol (CDP).

Pré-requisitos

• Bun (recomendado) ou Node.js (v14 ou superior)
• Navegador Chrome com depuração remota habilitada

Configuração

Instalando o Bun

1. Instale o Bun (se ainda não estiver instalado):

# macOS, Linux, or WSL
curl -fsSL https://bun.sh/install | bash

# Windows (using PowerShell)
powershell -c "irm bun.sh/install.ps1 | iex"

# Alternatively, using npm
npm install -g bun

2. Inicie o Chrome com depuração remota habilitada:

   # macOS
   /Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222
   
   # Windows
   start chrome --remote-debugging-port=9222
   
   # Linux
   google-chrome --remote-debugging-port=9222
   

3. Instale as dependências:

bun install

4. Inicie o servidor:

bun start

Para desenvolvimento com recarga automática:

bun dev

O servidor iniciará na porta 3000 por padrão. Você pode alterar isso definindo a variável de ambiente PORT.

Configurando o Roo Code para usar este servidor MCP

Para usar este servidor MCP com o Roo Code:

1. Abra as configurações do Roo Code

2. Navegue até o arquivo de configuração de MCP em:

   • macOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
   • Windows: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json
   • Linux: ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

3. Adicione a seguinte configuração ao objeto mcpServers:

{
  "mcpServers": {
    "chrome-control": {
      "url": "http://localhost:3000/sse",
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

4. Salve o arquivo e reinicie o Roo Code para aplicar as alterações.

5. Agora você pode usar as ferramentas do Chrome MCP no Roo Code para controlar o navegador.

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas para controle do navegador:

navigar

Navegue para uma URL específica.

Parâmetros:

• url (string): A URL para navegar

clicar

Clique em coordenadas específicas.

Parâmetros:

• x (número): Coordenada X
• y (número): Coordenada Y

digitar

Digite texto no foco atual.

Parâmetros:

• text (string): Texto a ser digitado

clicarElemento

Clique em um elemento pelo seu índice nas informações da página.

Parâmetros:

• selector (string): Índice do elemento (por exemplo, "0" para o primeiro elemento)

obterTexto

Obtenha o conteúdo de texto de um elemento usando um seletor CSS.

Parâmetros:

• selector (string): Seletor CSS para encontrar o elemento

obterInformacoesDaPagina

Obtenha informações semânticas sobre a página, incluindo elementos interativos e nós de texto.

obterEstadoDaPagina

Obtenha o estado atual da página, incluindo URL, título, posição de rolagem e tamanho da janela de visualização.

Uso

O servidor implementa o Model Context Protocol com transporte SSE. Conecte-se ao servidor em:

• Endpoint SSE: http://localhost:3000/sse
• Endpoint de mensagens: http://localhost:3000/message?sessionId=...

Ao usar com o Roo Code, a configuração no arquivo de configurações MCP lidará com a conexão automaticamente.

Desenvolvimento

Para executar o servidor em modo de desenvolvimento com recarga automática:

bun dev

Isso usa o modo de observação incorporado do Bun para reiniciar automaticamente o servidor quando os arquivos mudarem.

Licença

MIT