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.
Ambas distribuciones asumen que puedes acceder a los registros públicos, npmjs.org y Docker Hub. Si tu red restringe el acceso a ellos, consulta Instalación desde el Agora de Deque en su lugar.
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 | Node.js 22.19.0 o posterior |
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@$(npm view axe-mcp-server dependencies.playwright) install chromiumEsto deriva el pin del paquete publicado, por lo que se mantiene correcto a medida que el servidor se actualiza. Playwright debe estar fijado: un npx playwright install chromium simple se resolvería a la última versión de Playwright, lo que podría instalar una revisión de Chromium que el servidor no soporta.
¿Fijado a un axe-mcp-server más antiguo, o sin conexión? El comando anterior lee la dependencia de la versión última publicada. Si ejecutas una versión más antigua fijada, sustituye su versión de Playwright — npm view axe-mcp-server@<version> dependencies.playwright — o tómala del error de inicio de Chromium, que nombra el comando exacto para el servidor que realmente estás ejecutando. Al momento de escribir esto, la versión del servidor 1.4.0 incluye Playwright 1.61.1.
En Windows cmd.exe, que no tiene sustitución $(...), ejecuta npm view axe-mcp-server dependencies.playwright por sí solo y pega la versión en el comando. PowerShell, Git Bash y WSL manejan el comando tal como está escrito.
Consulta 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