Web Accessibility MCP Server
Servidor MCP de accesibilidad web
Un servidor MCP (Protocolo de contexto de modelo) que proporciona capacidades de análisis de accesibilidad web utilizando axe-core y Puppeteer.
Características
Analice la accesibilidad web de cualquier URL utilizando axe-core
Simular el daltonismo (protanopia, deuteranopia, tritanopia) utilizando matrices de color
Informes detallados de violaciones de accesibilidad
Compatibilidad con agentes de usuario y selectores personalizados
Registro de depuración para la resolución de problemas
Comprobaciones de accesibilidad exhaustivas basadas en las pautas WCAG
Related MCP server: Cursor A11y MCP
Prerrequisitos
Node.js (v14 o superior)
npm
Instalación
Instalación mediante herrería
Para instalar Web Accessibility MCP Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @bilhasry-deriv/mcp-web-a11y --client claudeInstalación manual
Clonar el repositorio:
git clone [repository-url]
cd mcp-web-a11yInstalar dependencias:
npm installConstruir el servidor:
npm run buildConfiguración
Agregue el servidor a su archivo de configuración de MCP (normalmente ubicado en ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):
{
"mcpServers": {
"web-a11y": {
"command": "node",
"args": ["/path/to/mcp-web-a11y/build/index.js"],
"disabled": false,
"autoApprove": [],
"env": {
"MCP_OUTPUT_DIR": "/path/to/output/directory"
}
}
}
}Variables de entorno
MCP_OUTPUT_DIR: Directorio donde se guardarán las salidas de captura de pantallaNecesario para la herramienta
simulate_colorblindSi no se especifica, el valor predeterminado es './output' relativo al directorio de trabajo actual
Debe ser una ruta absoluta cuando se configura en la configuración de MCP
Uso
El servidor proporciona dos herramientas: check_accessibility para analizar la accesibilidad web y simulate_colorblind para simular el daltonismo.
Herramienta: check_accessibility
Comprueba la accesibilidad de una URL determinada utilizando axe-core.
Parámetros
url(obligatorio): La URL a analizarwaitForSelector(opcional): selector CSS que se debe esperar antes del análisisuserAgent(opcional): cadena de agente de usuario personalizada para la solicitud
Ejemplo de uso
<use_mcp_tool>
<server_name>mcp-web-a11y</server_name>
<tool_name>check_accessibility</tool_name>
<arguments>
{
"url": "https://example.com",
"waitForSelector": ".main-content",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
}
</arguments>
</use_mcp_tool>Herramienta: simular_daltónico
Simula cómo aparece una página web para usuarios con diferentes tipos de daltonismo mediante transformaciones de matriz de color.
Tipos de daltonismo
La herramienta admite tres tipos de simulación de daltonismo:
Protanopia (ciego al rojo) - Utiliza matriz:
0.567, 0.433, 0 0.558, 0.442, 0 0, 0.242, 0.758Deuteranopia (ciego a la luz verde) - Utiliza la matriz:
0.625, 0.375, 0 0.7, 0.3, 0 0, 0.3, 0.7Tritanopia (ciego azul) - Utiliza matriz:
0.95, 0.05, 0 0, 0.433, 0.567 0, 0.475, 0.525
Parámetros
url(obligatorio): La URL a capturartype(obligatorio): Tipo de daltonismo a simular ('protanopia', 'deuteranopia' o 'tritanopia')outputPath(opcional): ruta personalizada para la salida de la captura de pantallauserAgent(opcional): cadena de agente de usuario personalizada para la solicitud
Ejemplo de uso
<use_mcp_tool>
<server_name>mcp-web-a11y</server_name>
<tool_name>simulate_colorblind</tool_name>
<arguments>
{
"url": "https://example.com",
"type": "deuteranopia",
"outputPath": "colorblind_simulation.png"
}
</arguments>
</use_mcp_tool>Formato de respuesta
Respuesta de check_accessibility
{
"url": "analyzed-url",
"timestamp": "ISO-timestamp",
"violations": [
{
"impact": "serious|critical|moderate|minor",
"description": "Description of the violation",
"help": "Help text explaining the issue",
"helpUrl": "URL to detailed documentation",
"nodes": [
{
"html": "HTML of the affected element",
"failureSummary": "Summary of what needs to be fixed"
}
]
}
],
"passes": 42,
"inapplicable": 45,
"incomplete": 3
}Respuesta de simular_daltónico
{
"url": "analyzed-url",
"type": "colorblind-type",
"outputPath": "path/to/screenshot.png",
"timestamp": "ISO-timestamp",
"message": "Screenshot saved with [type] simulation"
}Manejo de errores
El servidor incluye un manejo integral de errores para escenarios comunes:
Errores de red
URL no válidas
Problemas de tiempo de espera
Problemas de resolución de DNS
Las respuestas de error incluirán mensajes detallados para ayudar a diagnosticar el problema.
Desarrollo
Estructura del proyecto
mcp-web-a11y/
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript
├── output/ # Generated screenshots
├── package.json # Project dependencies and scripts
└── tsconfig.json # TypeScript configurationEdificio
npm run buildEsto hará lo siguiente:
Compilar TypeScript a JavaScript
Hacer que el archivo de salida sea ejecutable
Coloque los archivos compilados en el directorio
build
Depuración
El servidor incluye un registro de depuración detallado que se puede consultar en la salida de la consola. Esto incluye:
Solicitudes y respuestas de red
Estado de carga de la página
Estado de espera del selector
Cualquier mensaje de consola de la página analizada
Progreso de la simulación de color
Problemas comunes y soluciones
Errores de tiempo de espera
Aumente el valor de tiempo de espera en el código
Comprobar la conectividad de la red
Verificar que la URL sea accesible
Errores de resolución de DNS
Verifique que la URL sea correcta
Comprobar la conectividad de la red
Intente utilizar el subdominio www
Selector no encontrado
Verificar que el selector exista en la página
Espere a que se cargue el contenido dinámico
Verifique la fuente de la página para encontrar el selector correcto
Problemas de simulación de color
Asegúrese de que los colores de la página estén especificados en un formato compatible (RGB, RGBA o HEX)
Verifique si la página utiliza cambios de color dinámicos (puede requerir tiempo de espera adicional)
Verifique que el directorio de salida de la captura de pantalla exista y se pueda escribir
Contribuyendo
Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Available Tools
2 toolscheck_accessibilityC
Check web accessibility of a given URL using axe-core
Inputs: url (required), waitForSelector, userAgent.
simulate_colorblindC
Simulate how a webpage looks for colorblind users
Inputs: url (required), type (required), outputPath, userAgent.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one checks general web accessibility using axe-core, while the other specifically simulates colorblindness effects on a webpage. There is no overlap or ambiguity between them.
Both tools follow a consistent verb_noun pattern (check_accessibility, simulate_colorblind) with clear, descriptive names. The naming style is uniform and predictable throughout the set.
With only two tools, the server feels thin for a web accessibility domain. While the tools are useful, typical accessibility testing involves more operations like checking screen reader compatibility, keyboard navigation, or ARIA attributes, suggesting notable gaps in coverage.
The tool set is severely incomplete for web accessibility. It lacks core operations such as validating HTML structure, testing screen reader output, assessing keyboard accessibility, or generating accessibility reports, which are essential for comprehensive accessibility evaluation.
Maintenance
Related MCP Connectors
Scan URLs or HTML for WCAG 2.2 violations. 75-rule manifest, weighted score, shareable reports.
Deterministic axe-core accessibility scans (WCAG 2.1 AA, EN 301 549, PDF/UA) via your account.
Scan URLs for WCAG 2.1 violations, generate AI fixes, and produce VPAT 2.5 compliance reports.
Accessibility pre-checks (WCAG/BFSG) in a real browser + statement drafts. Pay per call.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables automated web accessibility scans for WCAG compliance using Playwright and Axe-core, providing visual and JSON reports with remediation guidance.252,963 npm59MIT
- AlicenseBqualityDmaintenanceProvides accessibility testing capabilities through CLI, helping identify accessibility issues in web applications using axe-core and Puppeteer.12MIT
- AlicenseBqualityDmaintenanceEnables AI agents to perform comprehensive accessibility audits on websites using Playwright and axe-core against WCAG standards. Provides detailed compliance reports with violation summaries and remediation guidance across multiple browsers.3MIT
- AlicenseNot gradedqualityDmaintenancePerforms automated web accessibility audits following WCAG standards using axe-core and Puppeteer, generating detailed reports in Spanish with recommended solutions and code examples.MIT