MCP Browser Debugger
Provides debugging capabilities for Angular applications through DOM inspection, JavaScript execution, console log monitoring, and network activity analysis
Enables inspection and analysis of CSS through DOM element querying, computed styles extraction, and CSS selector-based element targeting
Allows execution of arbitrary JavaScript code in browser context, console log monitoring, and JavaScript debugging capabilities
Provides debugging capabilities for React applications through DOM inspection, JavaScript execution, console log monitoring, and network activity analysis
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Browser Debugger navigate to https://example.com and show me the DOM"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Browser Debugger
Servidor MCP avançado para debugging completo de frontend com análise de DOM, execução de JavaScript3. 🆕 Fluxo completo: Login e inspeção:
"Primeiro, verifique se o browser está aberto.
Se estiver fechado, abra o browser visível.
Depois faça login em https://meusite.com/login usando:
- Campo email: #email
- Campo senha: #password
- Botão: button.submit
- Email: meu@email.com
- Senha: minhasenha
Depois me mostre o DOM da página logada"Debugar uma página web:o de rede e muito mais.
Desenvolvido em TypeScript com padrões profissionais de código (ESLint + Prettier).
🚀 Funcionalidades
🌐 Controle do Browser
open_browser: Abre o browser em modo VISÍVEL (headful) para você ver as ações do agent em tempo real
login: Faz login automatizado e mantém a sessão ativa para inspeção
Navegação e Carregamento
navigate: Navega para qualquer URL com controle de timeout e condições de espera
get_page_info: Obtém informações completas sobre a página atual
Análise de DOM
get_dom: Extrai o HTML completo do DOM
get_element: Inspeciona elementos específicos com estilos computados
query_selector_all: Busca múltiplos elementos por seletor CSS
evaluate_xpath: Avalia expressões XPath
Código Fonte
get_page_source: Extrai todo código fonte incluindo scripts e estilos
execute_js: Executa JavaScript arbitrário no contexto da página
Debugging e Monitoramento
get_console_logs: Captura todos os logs do console
get_network_activity: Monitora todas as requisições HTTP
screenshot: Captura screenshots da página ou elementos específicos
Interação
click_element: Clica em elementos
type_text: Digita texto em campos de input
Inspeção de Dados
get_local_storage: Acessa localStorage
get_cookies: Lista todos os cookies
Related MCP server: WebSee MCP Server
📦 Instalação
npm install
npm run build🛠️ Scripts Disponíveis
npm run dev # Desenvolvimento com ts-node
npm run start # Executa código compilado
npm run build # Compila TypeScript para JavaScript
npm run lint # Verifica código com ESLint
npm run lint:fix # Corrige problemas do ESLint automaticamente
npm run format # Formata código com Prettier
npm run format:check # Verifica formatação sem modificar⚙️ Configuração no Claude Desktop
Adicione ao seu arquivo de configuração do MCP client:
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"browser-debugger": {
"command": "node",
"args": ["c:\\Users\\Emmanuel\\Desktop\\mcp\\mcp-browser\\dist\\index.js"]
}
}
}Nota: Após qualquer alteração no código, execute npm run build antes de reiniciar o Claude Desktop.
🔧 Uso
⚠️ IMPORTANTE: Fluxo Correto para Evitar Perda de Sessão
SEMPRE siga esta ordem:
Primeiro: Verificar se browser está aberto
"Verifique se o browser está aberto"Se fechado: Abrir browser visível
"Abra o browser em modo visível"Fazer login (se necessário)
"Faça login em https://site.com/login usando..."Continuar usando SEM abrir browser novamente
"Navegue para...", "Me mostre o DOM", etc.
Exemplos de Comandos para o Agent
🆕 Verificar status do browser:
"Verifique se o browser está aberto"🆕 Abrir browser visível:
"Abra o browser em modo visível e navegue para https://google.com"🆕 Fluxo completo: Login e inspeção:
"Abra o browser visível, faça login em https://meusite.com/login usando:
- Campo email: #email
- Campo senha: #password
- Botão: button.submit
- Email: meu@email.com
- Senha: minhasenha
Depois me mostre o DOM da página logada"Debugar uma página web:
"Navegue para https://example.com e me mostre o DOM completo"Analisar erros de console:
"Navegue para https://meusite.com e me mostre todos os erros do console"Inspecionar elemento específico:
"Encontre o elemento com classe 'header' e me mostre seus estilos computados"Executar JavaScript customizado:
"Execute este código: document.querySelectorAll('img').length"Monitorar requisições de rede:
"Mostre todas as requisições HTTP que falharam (status 4xx ou 5xx)"Extrair código fonte:
"Me mostre todos os scripts inline e externos da página"Capturar screenshot:
"Tire um screenshot da página inteira"🛠️ Ferramentas Disponíveis
1. get_browser_status ⭐ NOVO - USE PRIMEIRO!
Verifica se o browser está aberto ou fechado. SEMPRE use esta ferramenta antes de abrir um novo browser!
Parâmetros: Nenhum
Retorno:
isOpen: Browser está aberto?headless: Modo headless (invisível) ou headful (visível)?currentUrl: URL atual da páginapageTitle: Título da página atualmessage: Mensagem explicativa
Exemplo de uso:
"Verifique se o browser está aberto"⚠️ Por que é importante:
Se você abrir um browser que já está aberto, perderá a sessão de login!
Use esta ferramenta para evitar loops infinitos
2. close_browser ⭐ NOVO
Fecha o browser e encerra a sessão.
Parâmetros: Nenhum
⚠️ ATENÇÃO:
Isso irá perder todos os cookies, localStorage e sessões de login!
Use apenas quando o usuário pedir explicitamente para fechar o browser
Após fechar, você precisará usar
open_browserpara abrir novamente
Exemplo de uso:
"Feche o browser"3. open_browser ⭐ NOVO
Abre o browser em modo VISÍVEL para você ver tudo que o agent está fazendo!
⚠️ ATENÇÃO: Use get_browser_status ANTES! Se o browser já estiver aberto, NÃO use esta ferramenta.
Parâmetros:
url: URL para abrir (opcional)headless: Se false, browser fica visível (padrão: false)width: Largura da janela (padrão: 1920)height: Altura da janela (padrão: 1080)
Exemplo de uso:
Passo 1: "Verifique se o browser está aberto"
Passo 2: Se fechado -> "Abra o browser visível em https://github.com"4. login ⭐ NOVO
Faz login automatizado e mantém a sessão aberta para inspeção.
Parâmetros:
url(obrigatório): URL da página de loginusernameSelector(obrigatório): Seletor CSS do campo username/emailpasswordSelector(obrigatório): Seletor CSS do campo senhasubmitSelector(obrigatório): Seletor CSS do botão de submitusername(obrigatório): Username ou emailpassword(obrigatório): SenhawaitForSelector: Seletor para confirmar login bem-sucedido (opcional)timeout: Timeout em ms (padrão: 30000)delayAfterType: Delay após digitar, útil para SPAs (padrão: 500)
Exemplo de uso:
"Faça login em https://exemplo.com/login usando:
- Campo de email: input[name='email']
- Campo de senha: input[type='password']
- Botão: button[type='submit']
- Email: usuario@exemplo.com
- Senha: minhasenha123"5. navigate
Navega para uma URL específica.
Parâmetros:
url(obrigatório): URL completawaitUntil: "load" | "domcontentloaded" | "networkidle0" | "networkidle2"timeout: Timeout em ms
6. get_dom
Extrai o HTML completo do DOM.
Parâmetros:
prettify: Formatar HTML (padrão: true)
7. get_element
Inspeciona um elemento específico.
Parâmetros:
selector(obrigatório): Seletor CSSincludeStyles: Incluir estilos computadosincludeAttributes: Incluir atributos
8. execute_js
Executa JavaScript no contexto da página.
Parâmetros:
code(obrigatório): Código JavaScriptreturnValue: Retornar valor da execução
9. screenshot
Captura screenshot.
Parâmetros:
selector: Elemento específico (opcional)fullPage: Página inteira com scrollpath: Caminho para salvar
10. get_console_logs
Recupera logs do console.
Parâmetros:
filterType: "all" | "log" | "error" | "warning" | "info"clear: Limpar logs após recuperação
11. get_network_activity
Recupera atividade de rede.
Parâmetros:
filterType: "all" | "request" | "response"clear: Limpar histórico
12. get_page_source
Extrai código fonte completo.
Parâmetros:
includeScripts: Incluir scriptsincludeStyles: Incluir estilos
13. query_selector_all
Busca múltiplos elementos.
Parâmetros:
selector(obrigatório): Seletor CSSlimit: Limitar resultados (padrão: 100)
14. get_page_info
Informações gerais da página.
15. click_element
Clica em um elemento.
Parâmetros:
selector(obrigatório): Seletor CSSwaitForNavigation: Aguardar navegação
16. type_text
Digita texto em input.
Parâmetros:
selector(obrigatório): Seletor CSStext(obrigatório): Texto a digitarclearFirst: Limpar antes de digitar
17. get_local_storage
Acessa localStorage.
18. get_cookies
Lista cookies.
19. evaluate_xpath
Avalia XPath.
Parâmetros:
xpath(obrigatório): Expressão XPath
🎯 Casos de Uso
Debugging de Aplicação React/Vue/Angular
1. Navegar para a aplicação
2. Capturar console logs e erros
3. Inspecionar componentes específicos
4. Executar JavaScript para verificar estado da aplicação
5. Monitorar requisições APIAnálise de Performance
1. Navegar com networkidle0
2. Capturar todas as requisições de rede
3. Analisar tamanho de recursos
4. Verificar tempo de carregamentoExtração de Dados
1. Navegar para a página
2. Executar query_selector_all para elementos desejados
3. Executar JavaScript customizado para processar dados
4. Extrair informações específicasTestes de UI
1. Navegar para a página
2. Interagir com elementos (click, type)
3. Verificar mudanças no DOM
4. Capturar screenshots de evidência🔒 Segurança
Browser executa em modo headless
Sandbox desabilitado apenas para compatibilidade local
Não armazena credenciais
Logs são mantidos em memória e podem ser limpos
📝 Notas
O browser é iniciado automaticamente na primeira ferramenta chamada
Uma única instância de página é mantida entre chamadas
Console logs e requisições de rede são acumulados entre navegações (use
clear: truepara limpar)Screenshots podem ser salvos em disco ou retornados como base64
Available Tools
15 toolsclick_elementC
Clica em um elemento da página
Inputs: selector (required), waitForNavigation.
evaluate_xpathC
Avalia uma expressão XPath e retorna os elementos correspondentes
Inputs: xpath (required).
execute_jsC
Executa código JavaScript arbitrário no contexto da página
Inputs: code (required), returnValue.
get_console_logsC
Recupera todos os logs do console capturados desde a última navegação
Inputs: clear, filterType.
get_cookiesB
Obtém todos os cookies da página atual
Inputs: no named parameters.
get_domC
Extrai o HTML completo do DOM atual da página
Inputs: prettify.
get_elementC
Inspeciona um elemento específico usando seletor CSS
Inputs: selector (required), includeAttributes, includeStyles.
get_local_storageB
Obtém todos os dados do localStorage
Inputs: no named parameters.
get_network_activityC
Recupera todas as requisições de rede capturadas
Inputs: clear, filterType.
get_page_infoB
Obtém informações gerais sobre a página atual
Inputs: no named parameters.
get_page_sourceB
Extrai todo o código fonte da página incluindo scripts, styles e recursos
Inputs: includeScripts, includeStyles.
query_selector_allC
Busca todos os elementos que correspondem ao seletor CSS
Inputs: selector (required), limit.
screenshotB
Captura uma screenshot da página ou de um elemento específico
Inputs: fullPage, path, selector.
type_textC
Digita texto em um campo de input
Inputs: selector (required), text (required), clearFirst.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Every tool has a clearly distinct purpose with no ambiguity. For example, click_element is for clicking, evaluate_xpath for XPath evaluation, get_dom for DOM extraction, and navigate for page navigation—each targets a specific browser debugging action without overlap.
All tool names follow a consistent verb_noun pattern in snake_case, such as click_element, get_cookies, and navigate. This predictability makes it easy for agents to understand and select the right tool based on its naming convention.
With 15 tools, the server is well-scoped for browser debugging, covering essential actions like navigation, DOM inspection, JavaScript execution, and data retrieval. Each tool earns its place without feeling excessive or insufficient for the domain.
The tool set provides complete coverage for browser debugging, including navigation, element interaction, data extraction, and monitoring. There are no obvious gaps; agents can handle full debugging workflows from page loading to inspection and interaction.
Maintenance
Related MCP Connectors
Live browser debugging for AI assistants — DOM, console, network via MCP.
Cloud browser, web extraction, screenshots, and remote CDP tools for AI agents.
Hosted browser for AI agents: screenshots, post-JS DOM, console, WCAG. No install, no API key.
Undetectable cloud browser sessions for AI agents and scrapers. Navigate, extract, click, captcha.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables reverse engineering of web applications and chat interfaces through browser automation, network traffic capture, and streaming API discovery. Provides comprehensive tools for analyzing network patterns, capturing streaming responses, and automating complex web interactions.1416 npm1ISC
- FlicenseNot gradedqualityNot gradedmaintenanceProvides AI assistants with advanced frontend debugging capabilities through 36 specialized tools for inspecting React/Vue/Angular/Svelte applications. Uses Playwright browser automation and source map intelligence to analyze components, network requests, bundle optimization, and resolve production errors.-
- AlicenseNot gradedqualityDmaintenanceProvides comprehensive Chrome browser debugging capabilities including DOM inspection, network monitoring, console logs, JavaScript execution, breakpoint debugging, and screenshot capture for AI-assisted frontend development.5MIT
- AlicenseAqualityBmaintenanceEnables AI coding assistants to debug and analyze JavaScript code in web pages through breakpoint debugging, function hooking, network analysis, and runtime inspection of scripts including minified code.241,083 npm3,084Apache 2.0