A11y MCP Server

Servidor MCP A11y

Un servidor MCP (Model Context Protocol) para realizar auditorías de accesibilidad en páginas web utilizando axe-core. ¡Usa los resultados en un bucle agéntico con tus asistentes de IA favoritos (Cline/Cursor/GH Copilot) y deja que corrijan los problemas de accesibilidad por ti!

Características

• Realiza auditorías de accesibilidad detalladas en cualquier página web
• Obtén un resumen de los problemas de accesibilidad
• Filtra auditorías por criterios WCAG específicos
• Incluye fragmentos de HTML en los resultados para facilitar la depuración

Instalación

# Install globally
npm install -g a11y-mcp

# Or use directly with npx
npx a11y-mcp

Configuración

Para usar este servidor MCP con Cline, debes agregarlo a tu archivo de configuración de ajustes de MCP.

Configuración de MCP

Agrega lo siguiente al objeto mcpServers:

{
  "mcpServers": {
    "a11y": {
      "command": "npx",
      "args": ["a11y-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Herramientas disponibles

audit_webpage

Realiza una auditoría de accesibilidad detallada en una página web.

Parámetros:

• url (obligatorio): URL de la página web a auditar
• includeHtml (opcional): Si se deben incluir fragmentos de HTML en los resultados (predeterminado: false)
• tags (opcional): Matriz de etiquetas de accesibilidad específicas para verificar (p. ej., wcag2a, wcag2aa, wcag21a, best-practice)

Ejemplo:

Use the a11y MCP server to audit example.com for accessibility issues

get_summary

Obtiene un resumen de los problemas de accesibilidad de una página web.

Parámetros:

• url (obligatorio): URL de la página web a auditar

Ejemplo:

Give me an accessibility summary of example.com

Ejemplo de uso

Una vez configurado, puedes pedirle a Claude que use el servidor MCP para realizar auditorías de accesibilidad:

1. "¿Puedes verificar si example.com tiene problemas de accesibilidad?"
2. "Audita mi sitio web en https://mywebsite.com para verificar el cumplimiento de WCAG 2.1 AA"
3. "Dame un resumen de los problemas de accesibilidad en https://example.com"
4. "Verifica si mi servidor de desarrollo local en http://localhost:3000 tiene algún problema crítico de accesibilidad"

Desarrollo

Para ejecutar el servidor localmente durante el desarrollo:

npm start

Publicación de versiones

Este proyecto incluye un script de publicación para ayudar con el versionado y la publicación en npm. El script se encarga de incrementar la versión, ejecutar pruebas, crear etiquetas de git y publicar en npm.

Para publicar una nueva versión:

# Make sure the script is executable
chmod +x release.sh

# Release a patch version (default)
./release.sh

# Release a minor version
./release.sh --minor

# Release a major version
./release.sh --major

# Release a specific version
./release.sh --version=1.2.3

# Skip git operations
./release.sh --skip-git

# Dry run (no changes will be made)
./release.sh --dry-run

# Force release even with uncommitted changes
./release.sh --force

Para más información, ejecuta:

./release.sh --help

Licencia

MPL 2.0

Créditos

Este proyecto se basa en el excelente trabajo realizado por axe-core

Seguridad y alojamiento

Requiere Node.js 22.12 o superior. Chrome se ejecuta con su sandbox habilitado. Cada conexión HTTP(S), incluidas las redirecciones y los subrecursos, pasa por un proxy de validación que fija la dirección IP de destino. Las direcciones privadas, de enlace local, multicast, reservadas y de metadatos de nube están bloqueadas, incluido IPv6 mapeado. El bucle local permanece disponible para el desarrollo local; configura AUDIT_ALLOW_LOOPBACK=false para auditorías solo públicas. Las direcciones LAN ya no son compatibles. Se ejecuta una auditoría por proceso MCP, con un plazo de 90 segundos para el navegador. Para uso alojado, además aísla los trabajadores del navegador y aplica restricciones de salida de red en la capa de infraestructura. Las comprobaciones automatizadas de axe no establecen conformidad con WCAG; aún se requiere revisión manual.

Ejecuta npm test, npm run test:smoke (requiere Chrome) y npm audit.