Servidor MCP A11y

Un servidor MCP (Protocolo de Contexto de Modelo) para realizar auditorías de accesibilidad en páginas web con axe-core. Usa los resultados en un bucle de agentes con tus asistentes de IA favoritos (Cline/Cursor/GH Copilot) y deja que solucionen todos los problemas.

Características

• Realice auditorías de accesibilidad detalladas en cualquier página web

• Obtenga un resumen de los problemas de accesibilidad

• Filtrar auditorías según criterios WCAG específicos

• Incluya fragmentos de HTML en los resultados para facilitar la depuración

Related MCP server: Cursor A11y MCP

Instalación

# Install globally
npm install -g a11y-mcp

# Or use directly with npx
npx a11y-mcp

Configuración

Para utilizar este servidor MCP con Cline, debe agregarlo a su archivo de configuración de MCP.

Configuración de MCP

Agregue lo siguiente al objeto mcpServers :

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

Herramientas disponibles

auditoría_página web

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 HTML en los resultados (valor predeterminado: falso)

• tags (opcional): Matriz de etiquetas de accesibilidad específicas para verificar (por ejemplo, wcag2a, wcag2aa, wcag21a, mejores prácticas)

Ejemplo:

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

obtener_resumen

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 consultar example.com para ver si hay problemas de accesibilidad?"

2. Audite mi sitio web en https://mywebsite.com para verificar su cumplimiento con WCAG 2.1 AA.

3. "Dame un resumen de los problemas de accesibilidad en https://example.com "

4. "Verificar si mi servidor de desarrollo local en http://localhost:3000 tiene algún problema crítico de accesibilidad"

Desarrollo

Para ejecutar el servidor localmente para el desarrollo:

npm start

Liberando

Este proyecto incluye un script de lanzamiento para facilitar el control de versiones y la publicación en npm. Este script gestiona el control de versiones, la ejecución de pruebas, el etiquetado en Git y la publicación en npm.

Para lanzar 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 obtener más información, ejecute:

./release.sh --help

Licencia

MPL 2.0

Créditos

Este proyecto se basa en el increíble trabajo realizado por axe-core