Notas de Lançamento Axe MCP Server Versão 1.4.0
Data de Lançamento
28 de julho de 2026
Visão Geral
Esta versão v1.4.0 traz Regras Avançadas para a ferramenta analyze e adiciona um captura de tela da página opcional à resposta analyze para que você possa ver o que foi escaneado.
Para obter esta versão:
- Docker — faça o re-download da imagem:
docker pull dequesystems/axe-mcp-server:latest - npm — não é necessário um passo de instalação separado;
npxexecuta a última versão publicada. Veja Escolhendo uma Distribuição.
Novas Funcionalidades
Regras Avançadas na Ferramenta analyze
O ferramenta analyze agora executa Regras Avançadas juntamente com o conjunto de regras padrão do axe-core. Essas regras utilizam capturas de tela, visão por computador e modelos de linguagem avançados para encontrar problemas que o axe-core sozinho não consegue — cabeçalhos que só parecem cabeçalhos, imagens informativas com texto alternativo ineficaz e contraste de texto sobre gradientes ou imagens. As descobertas avançadas são integradas ao mesmo array de resultados que seu agente já consome, portanto, nenhuma alteração nos seus prompts ou fluxo de trabalho é necessária.
Capturas de Tela na Ferramenta analyze
O ferramenta analyze agora aceita um parâmetro screenshot opcional que retorna uma imagem da página juntamente com o relatório de violações, como um bloco de conteúdo de imagem padrão MCP.
A captura cobre o viewport visível no momento logo antes do início do escaneamento — passe um viewportHeight alto para ver mais da página. A captura é feita com o melhor esforço e nunca falha um escaneamento: se houver um tempo limite, os resultados ainda retornam com uma nota em messages. E se o escaneamento falhar após a captura da tela, a imagem é retornada com a resposta de erro, fornecendo o estado visual da página no momento em que algo deu errado.
Solicite capturas de tela deliberadamente em vez de em todos os escaneamentos — um bloco de imagem consome tokens de entrada de imagem na próxima vez que seu agente for acionado, aproximadamente uma ordem de magnitude a mais do que o texto equivalente.
Se a imagem é renderizada inline depende do seu cliente MCP: o VS Code com o Copilot a exibe, enquanto o Cursor e o Claude Desktop podem colapsar o resultado da ferramenta ou omitir a pré-visualização. O servidor sempre retorna um bloco de imagem válido aos padrões, então uma pré-visualização ausente é uma limitação de exibição do lado do cliente e não uma falha na captura.
Veja Capturas de Tela para todos os detalhes.
Alterações
Viewport de Escaneamento Padrão Agora é 1000×1080
Quando viewportWidth e viewportHeight são ambos omitidos, analyze agora escaneia em 1000×1080 em vez do tamanho padrão do viewport do navegador. Isso torna os resultados reproduzíveis em diferentes distribuições e ambientes, e corresponde à largura que as Regras Avançadas usam para a análise de imagem — evitando um redimensionamento com perda da captura de tela.
Se os seus escaneamentos dependiam do viewport implícito anterior, defina viewportWidth e viewportHeight explicitamente. Veja Teste Responsivo.
Correções de Bugs
- Tokens OAuth expirados agora explicam como recuperar. Quando um token de acesso expira no meio de uma sessão, o erro que seu agente recebe indica a correção — reautenticar com
@deque/axe-authe reiniciar a conexão do servidor — em vez de apresentar uma rejeição opaca do backend. Veja Erros de Autenticação. - Corrigido
AXE_CHROME_PATHno Windows (distribuição npm). ApontarAXE_CHROME_PATHpara um binário válido do Chrome para Testes causava falha na inicialização no Windows comUnable to find specified chrome instance, porque a verificação de inicialização exigia quechrome.exe --versionsaísse corretamente — o que não acontece de forma confiável no Windows. O caminho agora é validado por sua existência no Windows. Caminhos inválidos ou ausentes ainda falham na inicialização em todas as plataformas. VejaAXE_CHROME_PATH.