Escáner de accesibilidad MCP 🔍

Name: MCP Accessibility Scanner
Author: JustasMonkev

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona análisis automatizado de accesibilidad web mediante Playwright y Axe-core. Este servidor permite a los LLM realizar comprobaciones de cumplimiento de WCAG, capturar capturas de pantalla con anotaciones y generar informes detallados de accesibilidad.

Características

✅ Comprobación completa del cumplimiento de WCAG 2.1/2.2
🖼️ Captura de pantalla automática con resaltado de infracciones
📄 Informes JSON detallados con orientación para la remediación

Related MCP server: Cursor A11y MCP

Instalación

Puede instalar el paquete utilizando cualquiera de estos métodos:

Usando npm:

npm install -g mcp-accessibility-scanner

Instalación de Docker

El proyecto incluye un Dockerfile que configura todas las dependencias necesarias, incluidos Node.js v22 y Python 3.13.

Construya la imagen de Docker:

docker build -t mcp-server .

Ejecute el contenedor:

docker run -it -e MCP_PROXY_DEBUG=true mcp-server

También puedes ejecutarlo en segundo plano:

docker run -d -p 3000:3000 mcp-server

Instalación en VS Code

Instale el escáner de accesibilidad en VS Code usando la CLI de VS Code:

Para VS Code:

code --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'

Para miembros de VS Code Insiders:

code-insiders --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'

Configuración

Aquí está la configuración de Claude Desktop:

{ "mcpServers": { "accessibility-scanner": { "command": "npx", "args": ["-y", "mcp-accessibility-scanner"] } } }

Uso

El escáner expone una única herramienta scan_accessibility que acepta:

url : La URL de la página web a escanear (obligatorio)
violationsTag : Matriz de etiquetas de violación de accesibilidad para verificar (obligatorio)
viewport : objeto opcional para personalizar el tamaño de la ventana gráfica
- width : número (predeterminado: 1920)
- height : número (predeterminado: 1080)
shouldRunInHeadless : valor booleano opcional para controlar el modo sin cabeza (valor predeterminado: verdadero)

Nota: Al ejecutar un escaneo, se guardará automáticamente en su carpeta de descargas una captura de pantalla anotada que resaltará cualquier violación de accesibilidad.

Ejemplo de uso en Claude:

Could you scan example.com for accessibility issues related to color contrast?

Ejemplo avanzado con opciones personalizadas:

Could you scan example.com for accessibility issues with a viewport of 1280x720 and show the browser window?

Desarrollo

Clonar y configurar el proyecto:

git clone https://github.com/JustasMonkev/mcp-accessibility-scanner.git cd mcp-accessibility-scanner npm install

Inicie el compilador de TypeScript en modo de observación:

npm run watch

Pruebe el servidor MCP localmente:

npm run inspector

Desarrollo de Docker

Para el desarrollo con Docker:

Construir la imagen de desarrollo:

docker build -t mcp-server-dev .

Ejecutar con montaje de volumen para cambios de código en vivo:

docker run -it -v $(pwd):/app -p 3000:3000 -e MCP_PROXY_DEBUG=true mcp-server-dev

Estructura del proyecto

├── src/ # Source code │ ├── index.ts # MCP server setup and tool definitions │ └── scanner.ts # Core scanning functionality ├── build/ # Compiled JavaScript output ├── Dockerfile # Docker configuration for containerized setup ├── package.json # Project configuration and dependencies └── tsconfig.json # TypeScript configuration