Eligiendo una Distribución
El servidor axe MCP se entrega en dos distribuciones. Ambas exponen el mismo analyze, remediate y igt herramientas y respetan el mismo configuración — sólo difieren en cómo el servidor se ejecuta en su máquina. Elija el que se adapte a su entorno; ninguno es preferido.
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 | Un versión LTS activa de Node.js |
Alcanzando localhost |
Necesita --add-host; vea ERR_CONNECTION_REFUSED |
Alcanza los servicios de host localhost directamente |
| 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 propio servidor — 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 un versión activa LTS de Node.js — es posible que las versiones anteriores no sean compatibles.
Instalar Chromium
Debido a que el servidor maneja un navegador real para ejecutar análisis, debe instalar una compilación de Chromium que coincida a través de Playwright:
npx playwright@1.60.0 install chromiumFije Playwright a la versión que envía el servidor axe MCP — actualmente 1.60.0. Un npx playwright install chromium solo resuelve la última versión de Playwright, lo que puede instalar una revisión de Chromium que el servidor no admite. Este pin puede cambiar entre las versiones del servidor; el error de inicio relacionado con Chromium lo señalará a Solución de problemas de la instalación de Chromium si las versiones divergen.
En Linux, también puede necesitar las bibliotecas del sistema de las que depende Chromium. Consulte Solución de problemas de la instalación de Chromium para más detalles.
Alternativa: usar un navegador que ya tengas
Si ya tiene un binario compatible de Chrome/Chromium en su máquina, puede omitir la instalación de Playwright y apuntar el servidor a él estableciendo la variable de entorno AXE_CHROME_PATH. Esto está disponible solo con la distribución npm — la imagen de Docker siempre usa su navegador incluido. Consulte AXE_CHROME_PATH para requisitos y advertencias.
Próximos pasos
- Configurar la autenticación — una clave API o OAuth 2.0
- Configure su cliente — VS Code con Copilot, Cursor o Claude Code