Escolhendo uma Distribuição
O axe MCP Server é distribuído em duas versões. Ambas expõem o mesmo analyze, remediate e igt ferramentas e respeitam o mesmo configuração — a diferença está apenas na maneira como o servidor opera na sua máquina. Escolha aquela que se adapta ao seu ambiente; nenhuma delas é preferencial.
Ambas as distribuições presumem que você pode acessar os registros públicos, npmjs.org e Docker Hub. Se sua rede restringe o acesso a eles, veja Instalando a partir do Agora da Deque em vez disso.
Docker vs. npm
| Docker | npm | |
|---|---|---|
| Tempo de Execução | Um container Docker | Um processo Node.js no seu host, lançado sob demanda com npx |
| Navegador | Incluído na imagem | Instale o Chromium via Playwright, ou aponte para um binário Chrome/Chromium existente que você já tenha |
| Pré-requisito | Docker instalado e em execução | Node.js 22.19.0 ou superior |
Alcançando localhost |
Precisa de --add-host; veja ERR_CONNECTION_REFUSED |
Alcança serviços do host localhost diretamente |
| Melhor quando | Você já usa Docker e quer um ambiente auto-suficiente | Você não pode executar o Docker, ou prefere um processo local mais leve |
Docker
Puxe a imagem inicialmente, e sempre que quiser migrar para uma versão mais recente:
docker pull dequesystems/axe-mcp-server:latestEsse é o único passo de instalação — seu cliente MCP lança o container sob demanda usando a configuração no seu guia de configuração do cliente.
npm
Não há um passo de instalação separado para o próprio servidor — npx -y axe-mcp-server baixa e executa sob demanda, e seu cliente MCP invoca esse comando por você (veja seu guia de configuração do cliente).
A distribuição npm é executada no Node.js. Use uma versão LTS ativa do Node.js — versões mais antigas podem não ser suportadas.
Instalar Chromium
Como o servidor controla um navegador real para executar varreduras, você deve instalar uma versão correspondente do Chromium por meio de Playwright:
npx playwright@$(npm view axe-mcp-server dependencies.playwright) install chromiumIsso deriva o pin do pacote publicado, para que permaneça correto à medida que o servidor é atualizado. O Playwright deve ser fixado: um npx playwright install chromium simples resolve para a versão mais recente do Playwright, que pode instalar uma revisão do Chromium que o servidor não suporta.
Fixado em um axe-mcp-server mais antigo, ou offline? O comando acima lê a dependência da versão mais recente publicada. Se você executar uma versão mais antiga fixada, substitua pela versão do Playwright — npm view axe-mcp-server@<version> dependencies.playwright — ou obtenha-a do erro de inicialização do Chromium, que nomeia o comando exato para o servidor que você está realmente executando. No momento da escrita, a versão do servidor 1.4.0 é fornecida com o Playwright 1.61.1.
No Windows cmd.exe, que não possui substituição de $(...), execute npm view axe-mcp-server dependencies.playwright sozinho e cole a versão no comando. PowerShell, Git Bash e WSL lidam com o comando conforme escrito.
Veja Solução de problemas na instalação do Chromium se as versões divergirem.
No Linux, você também pode precisar das bibliotecas do sistema das quais o Chromium depende. Veja Solução de problemas na instalação do Chromium para mais detalhes.
Alternativa: use um navegador que você já tem
Se você já possui um binário compatível do Chrome/Chromium na sua máquina, pode pular a instalação do Playwright e apontar o servidor para ele, configurando a variável de ambiente AXE_CHROME_PATH. Isso está disponível apenas com a distribuição npm — a imagem Docker sempre usa seu navegador incorporado. Veja AXE_CHROME_PATH para requisitos e advertências.
Próximos passos
- Configurar autenticação — uma chave API ou OAuth 2.0
- Configure seu cliente — VS Code com Copilot, Cursor ou Claude Code