Browser Control MCP

Browser Control MCP

Um servidor MCP emparelhado com uma extensão do Firefox que fornece aos assistentes de IA acesso ao gerenciamento de abas, histórico de navegação e conteúdo de texto de páginas da web.

Recursos

O servidor MCP suporta as seguintes ferramentas:

• Abrir ou fechar abas
• Obter a lista de abas abertas
• Criar grupos de abas com nome e cor
• Reordenar abas abertas
• Ler e pesquisar o histórico do navegador
• Ler o conteúdo de texto e links de uma página da web (requer consentimento do usuário)
• Encontrar e destacar texto em uma aba do navegador (requer consentimento do usuário)
• Capturar uma captura de tela da área visível de uma aba (requer consentimento do usuário por aba)

Exemplos de casos de uso:

Gerenciamento de abas

• "Feche todas as abas não relacionadas ao trabalho no meu navegador."
• "Agrupe todas as abas relacionadas a desenvolvimento no meu navegador em um novo grupo chamado 'Desenvolvimento'."
• "Reorganize as abas do meu navegador em uma ordem que faça sentido."
• "Feche todas as abas do meu navegador que não foram acessadas nas últimas 24 horas."

Pesquisa no histórico do navegador

• "Ajude-me a encontrar um artigo no meu histórico do navegador sobre a trilha Milford na Nova Zelândia."
• "Abra todos os artigos sobre IA que visitei durante a última semana, até 10 artigos, evitando duplicações."

Navegação e pesquisa

• "Abra o hackernews no meu navegador, depois abra a principal notícia, leia-a e também leia os comentários. Os comentários concordam com a notícia?"
• "No meu navegador, use o Google Acadêmico para pesquisar artigos sobre L-teanina nos últimos 3 anos. Abra os 3 artigos mais citados. Leia-os e resuma-os para mim."
• "Use a pesquisa do Google no meu navegador para procurar floriculturas. Abra os 10 resultados mais relevantes. Mostre-me uma tabela de cada floricultura com localização e horário de funcionamento."

Comparação com servidores MCP de automação web

A combinação do servidor MCP e da extensão do Firefox foi projetada para ser mais segura do que os servidores MCP de automação web, permitindo um uso mais seguro com o navegador pessoal do usuário.

• Não suporta modificação de páginas da web, interações com páginas ou scripts arbitrários.
• A leitura do conteúdo de páginas da web requer o consentimento explícito do usuário no navegador para cada domínio. Isso é aplicado no nível do manifesto da extensão.
• As capturas de tela exigem que o usuário autorize cada aba individualmente clicando no botão da barra de ferramentas da extensão. A extensão depende da permissão activeTab para isso, portanto, a autorização é aplicada pelo próprio Firefox e expira quando a aba navega ou fecha. A extensão nunca solicita permissões amplas de host para capturas de tela.
• Usa uma conexão somente local com um segredo compartilhado entre o servidor MCP e a extensão.
• Sem coleta de dados remota ou rastreamento.
• Fornece um registro de auditoria no lado da extensão para chamadas de ferramentas e configuração de ativação/desativação de ferramentas.
• A extensão não inclui dependências de terceiros em tempo de execução.

Nota importante: O Browser Control MCP ainda é experimental. Use por sua conta e risco. Você deve ter cautela como com qualquer outro servidor MCP e autorizar/monitorar as chamadas de ferramentas com cuidado.

Instalação

Opção 1: Instalar as extensões do Firefox e do Claude Desktop

A extensão / complemento do Firefox está disponível em addons.mozilla.org. Você também pode baixar e abrir a versão pré-compilada mais recente deste repositório GitHub: browser-control-mcp-1.5.0.xpi. Complete a instalação seguindo as instruções na página "Gerenciar extensão", que será aberta automaticamente após a instalação.

A página "Gerenciar extensão" do complemento incluirá um link para o arquivo DXT do Claude Desktop. Você também pode baixá-lo aqui: mcp-server-v1.5.2.dxt. Após baixar o arquivo, abra-o ou arraste-o para a janela de configurações do Claude Desktop. Certifique-se de ativar a extensão DXT após instalá-la. Isso funcionará apenas com as versões mais recentes do Claude Desktop. Se você deseja instalar o servidor MCP localmente, consulte a configuração do MCP abaixo.

Opção 2: Compilar a partir do código

Para compilar a partir do código, clone este repositório e execute os seguintes comandos no diretório principal do repositório para compilar tanto o servidor MCP quanto a extensão do navegador.

npm install
npm run build

Instalando um complemento temporário no Firefox

Para instalar a extensão no Firefox como um complemento temporário:

1. Digite about:debugging na barra de URL do Firefox
2. Clique em "Este Firefox"
3. Clique em "Carregar complemento temporário..."
4. Selecione o arquivo manifest.json na pasta firefox-extension deste projeto
5. A página de preferências da extensão será aberta. Copie a chave secreta para a área de transferência. Ela será usada para configurar o servidor MCP.

Alternativamente, para instalar um complemento permanente, você pode instalar o Browser Control MCP em addons.mozilla.org e depois configurar o servidor MCP conforme detalhado abaixo.

Se você preferir não executar a extensão no seu navegador Firefox pessoal, uma alternativa é baixar uma instância separada do Firefox (como o Firefox Developer Edition, disponível em https://www.mozilla.org/en-US/firefox/developer/).

Configuração do servidor MCP

Após instalar a extensão do navegador, adicione a seguinte configuração à sua configuração de mcpServers (por exemplo, claude_desktop_config.json para o Claude Desktop):

{
    "mcpServers": {
        "browser-control": {
            "command": "node",
            "args": [
                "/path/to/repo/mcp-server/dist/server.js"
            ],
            "env": {
                "EXTENSION_SECRET": "<secret_on_firefox_extension_options_page>",
                "EXTENSION_PORT": "8089" 
            }
        }
    }
}

Substitua /path/to/repo pelo caminho correto.

Defina a variável EXTENSION_SECRET com o valor exibido na página de preferências da extensão no Firefox (você pode acessá-la em about:addons). Você também pode definir a variável de ambiente EXTENSION_PORT para especificar a porta que o servidor MCP usará para se comunicar com a extensão (o padrão é 8089).

Pode levar alguns segundos para o servidor MCP se conectar à extensão.

Configurar o servidor MCP com Docker

Alternativamente, você pode usar uma configuração baseada em Docker. Para isso, compile a imagem Docker do mcp-server:

docker build -t browser-control-mcp .

e use a seguinte configuração de mcpServers:

{
    "mcpServers": {
        "browser-control": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-p", "127.0.0.1:8089:8089",
                "-e", "EXTENSION_SECRET=<secret_from_extension>",
                "-e", "CONTAINERIZED=true",
                "browser-control-mcp"
            ]
        }
    }
}