Escolhendo uma Distribuição

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

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.

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 Um liberação LTS ativa do Node.js
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:latest

Esse é 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@1.60.0 install chromium
note

Fixa o Playwright na versão que o axe MCP Server distribui — atualmente 1.60.0. Um npx playwright install chromium simples resolve para a última versão do Playwright, o que pode instalar uma revisão do Chromium que o servidor não suporta. Essa fixação pode mudar entre lançamentos do servidor; o erro de inicialização relacionado ao Chromium indica 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

  1. Configurar autenticação — uma chave API ou OAuth 2.0
  2. Configure seu cliente — VS Code com Copilot, Cursor ou Claude Code

Is this page helpful?

Help us improve this page

Still need help?