Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades de pruebas de accesibilidad a agentes de IA. Esta herramienta ayuda a identificar problemas de accesibilidad en aplicaciones web mediante Axe-Core y Puppeteer.

Características

Ejecute pruebas de accesibilidad en cualquier URL o servidor de desarrollo local
Desarrollado por axe-core para pruebas de accesibilidad integrales
Proporciona informes detallados de violaciones que incluyen:
- Nivel de impacto
- Descripción del problema
- Texto de ayuda y enlaces a la documentación
- Elementos HTML afectados
- Resúmenes de fallos

Related MCP server: Web Accessibility MCP Server

Estructura del proyecto

src/ - Código fuente para el servidor MCP y la herramienta de pruebas de accesibilidad
test-site/ - Una aplicación React con problemas de accesibilidad intencionales para realizar pruebas
build/ - Versión compilada del código fuente

Instalación

npm install

Luego instale las dependencias del sitio de prueba:

cd test-site npm install cd ..

Uso

Iniciar el servidor MCP

npm run build npm start

Ejecución del sitio de prueba

npm run start:test-site

El sitio de prueba estará disponible en http://localhost:5000 .

Ejecución de pruebas de accesibilidad

La herramienta acepta dos tipos de entradas:

Una URL completa para probar
Una ruta relativa que se agregará a http://localhost:5000

Dependencias

@modelcontextprotocol/sdk : ^1.4.1
puppeteer : ^24.1.1
zod : ^3.24.1

Dependencias del sitio de prueba

react : ^18.2.0
react-dom : ^18.2.0
react-scripts : 5.0.1

Desarrollo

Realizar cambios en el código fuente en el directorio src/
Ejecute npm run build para compilar los cambios
Inicie el servidor con npm start

Configuración en Cursor

Para agregar esta herramienta de prueba de accesibilidad a la configuración del servidor MCP de Cursor:

Abrir la configuración del cursor (⌘ + ,)
Vaya a "Características" > "Servidores MCP".
Agregue un nuevo servidor MCP con la siguiente configuración:
- Nombre: a11y
- Seleccione command del menú desplegable
- Comando: node path/to/cursor-a11y-mcp/index/file/in/build/folder (Reemplace path/to/cursor-a11y-mcp/index/file/in/build/folder con la ruta absoluta a su archivo index.js en la carpeta de compilación).
Haga clic Add
La herramienta de pruebas de accesibilidad ahora estará disponible en Cursor Composer

Uso en Composer

Para utilizar la herramienta de pruebas de accesibilidad en Cursor's Composer:

Ejecuta en tu terminal:

npm run start:test-site

Esto iniciará el sitio de prueba en http://localhost:5000

En el Compositor del cursor, escriba use a11y tool
Composer le solicitará que ejecute la herramienta
Después de ejecutar la herramienta, verá las violaciones de accesibilidad en la respuesta y las acciones del código para corregirlas.
Es posible que el Compositor le solicite que utilice la herramienta nuevamente para confirmar que se hayan corregido las infracciones.