Eligiendo una Distribución
El servidor axe MCP se entrega en dos distribuciones. Ambas exponen las mismas analyze, remediatey igt herramientas y respetan la misma configuración — solo difieren en cómo el servidor se ejecuta en su máquina. Elija la que se adapte a su entorno; ninguna es preferida.
Docker vs. npm
| Docker | npm | |
|---|---|---|
| Tiempo de ejecución | Un contenedor Docker | Un proceso de Node.js en su host, lanzado bajo demanda con npx |
| Navegador | Incluido en la imagen | Instalar Chromium a través de Playwright, o apuntar a un binario existente de Chrome/Chromium que ya tenga |
| Requisito previo | Docker instalado y en ejecución | Una versión LTS activa de Node.js |
Accediendo a localhost |
Necesita --add-host; vea ERR_CONNECTION_REFUSED |
Accede directamente a los localhost servicios del host |
| Mejor cuando | Ya usas Docker y deseas un entorno autónomo | No puedes ejecutar Docker, o prefieres un proceso local más liviano |
Docker
Obtenga la imagen inicialmente, y cada vez que desee pasar a una versión más nueva:
docker pull dequesystems/axe-mcp-server:latestEse es el único paso de instalación — su cliente MCP lanza el contenedor bajo demanda usando la configuración en su guía de configuración del cliente.
npm
No hay un paso de instalación separado para el servidor en sí — npx -y axe-mcp-server lo descarga y ejecuta bajo demanda, y su cliente MCP invoca ese comando por usted (vea su guía de configuración del cliente).
La distribución de npm se ejecuta en Node.js. Use una versión activa LTS de Node.js — es posible que las versiones anteriores no sean compatibles.
Instalar Chromium
Debido a que el servidor utiliza un navegador real para realizar escaneos, debe instalar una versión compatible de Chromium a través de Playwright:
npx playwright@1.60.0 install chromiumFije Playwright a la versión que el servidor axe MCP usa — actualmente 1.60.0. Una sencilla npx playwright install chromium se resuelve con la última versión de Playwright, que puede instalar una revisión de Chromium que el servidor no soporta. Este ajuste puede cambiar entre versiones del servidor; el error de inicio relacionado con Chromium le indicará Solución de Problemas de Instalación de Chromium si las versiones se desincronizan.
En Linux, también puede necesitar las bibliotecas del sistema de las que Chromium depende. Vea Solución de problemas de la instalación de Chromium para más detalles.
Alternativa: usar un navegador que ya tengas
Si ya tienes un binario compatible de Chrome/Chromium en tu máquina, puedes omitir la instalación de Playwright y apuntar al servidor en su lugar configurando la AXE_CHROME_PATH variable de entorno. Esto está disponible solo con la distribución npm — la imagen Docker siempre usa su navegador incluido. Consulta AXE_CHROME_PATH para requisitos y advertencias.
Próximos pasos
- Configurar la autenticación — una clave API o OAuth 2.0
- Configurar tu cliente — VS Code con Copilot, Cursor, o Claude Code