Cursor A11y MCP

Cursor A11y MCP

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

Luego instale las dependencias del sitio de prueba:

Uso

Iniciar el servidor MCP

Ejecución del sitio de prueba

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

Ejecución de pruebas de accesibilidad

La herramienta acepta dos tipos de entradas:

1. Una URL completa para probar
2. 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

1. Realizar cambios en el código fuente en el directorio src/
2. Ejecute npm run build para compilar los cambios
3. 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:

1. Abrir la configuración del cursor (⌘ + ,)
2. Vaya a "Características" > "Servidores MCP".
3. 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).
4. Haga clic Add
5. 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:

1. Ejecuta en tu terminal:

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

2. En el Compositor del cursor, escriba use a11y tool
3. Composer le solicitará que ejecute la herramienta
4. Después de ejecutar la herramienta, verá las violaciones de accesibilidad en la respuesta y las acciones del código para corregirlas.
5. 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