Repolode
AgentDeskAI

AgentDeskAI/browser-tools-mcp

Um servidor MCP e uma extensão do Chrome que dão a agentes de programação com IA acesso a logs do console, tráfego de rede, capturas de tela e auditorias do Lighthouse na sua sessão autenticada do Chrome.

Estrelas
7,332
Forks
536
Issues abertas
2
Último commit
há 8 dias

O que é?

O BrowserTools MCP permite que um agente de programação com IA inspecione a página em que você está trabalhando. Ele se conecta à sua sessão atual do Chrome por meio de uma extensão do DevTools, mantendo você conectado, e transmite a saída do console, a atividade de rede, capturas de tela e resultados de auditorias do Lighthouse para qualquer cliente compatível com MCP, como Cursor, Claude Code, Windsurf, Cline, Zed ou Gemini CLI.

O projeto é voltado à depuração de aplicações em execução, não à criação de testes automatizados. Servidores focados em automação, como Chrome DevTools MCP ou Playwright MCP, iniciam um perfil de navegador novo, o que exige recriar o estado de login antes de depurar. Já o BrowserTools lê a sessão que você já tem aberta. A configuração exige apenas um comando para iniciar o servidor MCP e carregar a extensão incluída como uma extensão descompactada do Chrome; o próprio servidor executa o conector.

O servidor aceita conexões apenas pelo loopback, exige um token exclusivo por execução para a API HTTP e remove credenciais, como cabeçalhos Authorization e Cookie, além de formatos comuns de tokens, dos dados capturados. Várias abas com o DevTools aberto são rastreadas separadamente, e cargas grandes ficam disponíveis como recursos MCP, entrando no contexto do agente somente quando solicitadas.

Recursos principais

  • 01Transmite logs e erros do console, além de requisições de rede, da aba atual do Chrome.
  • 02Captura imagens da tela e as envia ao agente.
  • 03Executa auditorias do Lighthouse de acessibilidade, desempenho, SEO e boas práticas.
  • 04Remove credenciais dos cabeçalhos e das strings capturados antes que saiam do navegador.
  • 05Rastreia várias abas separadamente e permite que as ferramentas direcionem uma aba específica pelo ID.
  • 06Oferece filtragem e paginação dos resultados dos logs para manter as respostas pequenas.

Casos de uso

  • Pedir a um agente que diagnostique erros do console em uma página na qual você está conectado.
  • Depurar requisições de API com falha ou lentas enquanto desenvolve uma aplicação web localmente.
  • Executar auditorias do Lighthouse em uma página sem configurar um perfil de teste separado.
  • Pedir a um agente que confira visualmente uma alteração na interface analisando uma captura de tela da página em execução.

Início rápido

  1. 1

    Adicione o servidor MCP à configuração do seu cliente MCP

    npx -y @agentdeskai/browser-tools-mcp@latest
  2. 2

    Baixe ou clone o repositório

  3. 3

    Em chrome://extensions, ative o modo do desenvolvedor e carregue o diretório chrome-extension descompactado

  4. 4

    Abra o Chrome DevTools (F12) na página que deseja inspecionar

Antes de usar

  • É necessário usar Node 22.19 ou mais recente.
  • O Firefox não foi verificado e é considerado não compatível.
  • A captura de rede registra apenas as solicitações feitas depois que o DevTools é aberto.

Em coleções

Tópicos

Perguntas frequentes

O que é browser-tools-mcp?
Um servidor MCP e uma extensão do Chrome que dão a agentes de programação com IA acesso a logs do console, tráfego de rede, capturas de tela e auditorias do Lighthouse na sua sessão autenticada do Chrome. O BrowserTools MCP permite que um agente de programação com IA inspecione a página em que você está trabalhando. Ele se conecta à sua sessão atual do Chrome por meio de uma extensão do DevTools, mantendo você conectado, e transmite a saída do console, a atividade de rede, capturas de tela e resultados de auditorias do Lighthouse para qualquer cliente compatível com MCP, como Cursor, Claude Code, Windsurf, Cline, Zed ou Gemini CLI.
browser-tools-mcp é gratuito? Qual é a licença?
browser-tools-mcp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
browser-tools-mcp ainda é mantido?
Manutenção ativa. O último commit de browser-tools-mcp foi em 16 de out. de 2026.
Para que posso usar browser-tools-mcp?
Pedir a um agente que diagnostique erros do console em uma página na qual você está conectado. Depurar requisições de API com falha ou lentas enquanto desenvolve uma aplicação web localmente. Executar auditorias do Lighthouse em uma página sem configurar um perfil de teste separado. Pedir a um agente que confira visualmente uma alteração na interface analisando uma captura de tela da página em execução.
Como instalar browser-tools-mcp?
Adicione o servidor MCP à configuração do seu cliente MCP: npx -y @agentdeskai/browser-tools-mcp@latest Baixe ou clone o repositório Em chrome://extensions, ative o modo do desenvolvedor e carregue o diretório chrome-extension descompactado Abra o Chrome DevTools (F12) na página que deseja inspecionar
Onde consigo browser-tools-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/AgentDeskAI/browser-tools-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados