Notas de la versión 1.4.0 de Axe MCP Server
Fecha de lanzamiento
28 de julio de 2026
Resumen
Esta versión v1.4.0 trae Reglas avanzadas a la herramienta analyze y añade una captura de pantalla de la página opcional a la respuesta analyze para que pueda ver lo que se escaneó.
Para obtener esta versión:
- Docker — vuelva a descargar la imagen:
docker pull dequesystems/axe-mcp-server:latest - npm — no se requiere un paso de instalación separado;
npxejecuta la última versión publicada. Vea Elegir una distribución.
Nuevas características
Reglas avanzadas en la herramienta analyze
La herramienta analyze ahora ejecuta Reglas avanzadas junto con el conjunto de reglas estándar de axe-core. Estas reglas usan capturas de pantalla, visión por computadora y modelos de lenguaje grande para encontrar problemas que axe-core solo no puede — títulos que solo parecen títulos, imágenes informativas con texto alternativo no útil y contraste de texto sobre degradados o imágenes. Los hallazgos avanzados se fusionan en el mismo arreglo de resultados que su agente ya consume, por lo que no se requiere ningún cambio en sus indicaciones o flujo de trabajo.
Capturas de pantalla de la página en la herramienta analyze
La herramienta analyze ahora acepta un parámetro screenshot opcional que devuelve una imagen de la página junto con el informe de violación, como un bloque de contenido de imagen MCP estándar.
La captura cubre la vista visible en el momento justo antes de que comience el escaneo — pase una viewportHeight alta para ver más de la página. La captura es lo mejor posible y nunca falla un escaneo: si se agota el tiempo, los resultados aún regresan con una nota en messages. Y si la escanear falla después de que se tomó la captura de pantalla, la imagen se devuelve con la respuesta de error, dándole el estado visual de la página en el momento en que algo salió mal.
Solicite capturas de pantalla deliberadamente en lugar de en cada escaneo — un bloque de imagen cuesta tokens de entrada de imagen en la siguiente operación de su agente, aproximadamente un orden de magnitud más que el texto equivalente.
Si la imagen se renderiza en línea depende de su cliente MCP: VS Code con Copilot la muestra, mientras que Cursor y Claude Desktop pueden colapsar el resultado de la herramienta u omitir la vista previa. El servidor siempre devuelven un bloque de imagen válido por especificación, por lo que una vista previa que falta es una limitación de visualización del lado del cliente en lugar de una captura fallida.
Vea Capturas de pantalla para obtener detalles completos.
Cambios
Vista predeterminada de escaneo ahora es 1000×1080
Cuando viewportWidth y viewportHeight ambos se omiten, analyze ahora escanea en 1000×1080 en lugar del tamaño de vista predeterminado del navegador. Esto hace que los resultados sean reproducibles entre distribuciones y entornos, y coincide con el ancho que las Reglas Avanzadas usan para el análisis de imágenes — evitando un cambio de tamaño con pérdida de la captura de pantalla.
Si sus escaneos dependían de la anterior vista implícita, configure viewportWidth y viewportHeight explícitamente. Vea Pruebas de respuesta.
Corrección de errores
- Los tokens OAuth expirados ahora explican cómo recuperarse. Cuando un token de acceso expira a mitad de sesión, el error que recibe su agente nombra la solución — re-autentíquese con
@deque/axe-authy reinicie la conexión del servidor — en lugar de presentar un rechazo opaco del backend. Vea Errores de autenticación. - Arreglado
AXE_CHROME_PATHen Windows (distribución de npm). ApuntarAXE_CHROME_PATHa un binario válido de Chrome para Testing causaba un choque en el inicio en Windows conUnable to find specified chrome instance, porque la verificación de inicio requería quechrome.exe --versionsaliera limpiamente — lo cual no hace de manera confiable en Windows. Ahora, la ruta se valida por su existencia en Windows. Las rutas inválidas o faltantes todavía fallan al inicio en todas las plataformas. VeaAXE_CHROME_PATH.