Escáner de accesibilidad MCP

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

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

scan_accessibility

Permite realizar escaneos automatizados de accesibilidad web para el cumplimiento de WCAG utilizando Playwright y Axe-core, proporcionando informes visuales y JSON con orientación para la remediación.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Web Accessibility MCP Server
bilhasry-deriv
A
security
A
license
A
quality
Provides web accessibility analysis and color blindness simulation using axe-core and Puppeteer, enabling detailed accessibility checks and visual simulations based on WCAG guidelines.
Last updated -
2
1
JavaScript
MIT License
Cursor A11y MCP
westsideori
A
security
A
license
A
quality
Provides accessibility testing capabilities through CLI, helping identify accessibility issues in web applications using axe-core and Puppeteer.
Last updated -
1
JavaScript
MIT License
a11y-mcp
priyankark
-
security
-
license
-
quality
An MCP (Model Context Protocol) server for performing accessibility audits on webpages using axe-core. Use the results in an agentic loop with your favorite AI assistants (Cline/Cursor/GH Copilot) and let them fix a11y issues for you!
Last updated -
JavaScript
Mozilla Public License 2.0
Playwright MCP
markbustamante77
A
security
A
license
A
quality
A Model Context Protocol server that provides browser automation capabilities using Playwright, enabling LLMs to interact with web pages through structured accessibility snapshots without requiring screenshots or vision models.
Last updated -
21
74,440
TypeScript
Apache 2.0

View all related MCP servers

MCP Accessibility Scanner