Cursor A11y MCP

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Uses Puppeteer to enable accessibility testing on web applications by automating browser interactions to capture and analyze page content.
Provides accessibility testing for React applications, with specific support for testing React components for accessibility violations.
Leverages Zod for schema validation within the accessibility testing workflow to ensure proper data formatting and validation.

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

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.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Versión

Versión actual: 2.0.1

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

a11y

Proporciona capacidades de pruebas de accesibilidad a través de CLI, lo que ayuda a identificar problemas de accesibilidad en aplicaciones web que utilizan axe-core y Puppeteer.

Related Resources

Reddit Discussion about this server