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 servidor axe MCP é fornecido em duas distribuições. Ambas expõem as mesmas analyze, remediate, e igt ferramentas e respeitam a mesma configuração — elas diferem apenas na forma como o servidor é executado em sua máquina. Escolha a que melhor se adapta ao seu ambiente; nenhuma é preferencial.

Docker vs. npm

Docker npm
Tempo de Execução Um container Docker Um processo Node.js no seu host, iniciado 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 Uma liberação LTS ativa do Node.js
Alcançando localhost Necessita de --add-host; veja ERR_CONNECTION_REFUSED Alcance o host localhost serviços 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 — o seu cliente MCP lança o container sob demanda usando a configuração em seu guia de configuração do cliente.

npm

Não há um passo de instalação separado para o servidor em si — npx -y axe-mcp-server o baixa e executa sob demanda, e seu cliente MCP invoca esse comando para 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 utiliza um navegador real para executar varreduras, você deve instalar manualmente uma versão correspondente do Chromium via Playwright:

npx playwright@1.60.0 install chromium
note

Fixe o Playwright na versão que o servidor axe MCP fornece — atualmente 1.60.0. Um npx playwright install chromium resulta na versão mais recente do Playwright, que pode instalar uma revisão do Chromium que o servidor não suporta. Este fixo pode mudar entre as versões do servidor; o erro de inicialização relacionado ao Chromium aponta para Solução de Problemas de Instalação do Chromium se as versões divergem.

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 detalhes.

Alternativa: use um navegador que você já tem

Se você já tem um binário compatível do Chrome/Chromium em 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 . Esta opção está disponível apenas com a distribuição npm — a imagem Docker sempre usa o navegador incluído. Veja AXE_CHROME_PATH para requisitos e alertas.

Próximos passos

  1. Configurar autenticação — uma chave de 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?