Escáner de accesibilidad MCP 🔍

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