A
securityA
licenseA
qualityProvides 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
4
MIT License
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áficawidth: 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)
Related MCP Servers
- AsecurityAlicenseAqualityProvides accessibility testing capabilities through CLI, helping identify accessibility issues in web applications using axe-core and Puppeteer.Last updated -12MIT License
- AsecurityAlicenseAqualityAn 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 -223829Mozilla Public License 2.0
- AsecurityAlicenseAqualityAn MCP server that enables LLMs to perform web accessibility testing against WCAG standards using Deque Axe-core API and Puppeteer.Last updated -66639MIT License