a11y-mcp

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

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:

"¿Puedes consultar example.com para ver si hay problemas de accesibilidad?"
Audite mi sitio web en https://mywebsite.com para verificar su cumplimiento con WCAG 2.1 AA.
"Dame un resumen de los problemas de accesibilidad en https://example.com "
"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

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested