A
securityA
licenseA
qualityEnables automated web accessibility scans for WCAG compliance using Playwright and Axe-core, providing visual and JSON reports with remediation guidance.
Last updated -
1
86
6
TypeScript
MIT License
The Cursor A11y MCP server allows you to test web applications for accessibility issues using axe-core and Puppeteer. It enables you to:
- Run accessibility tests on any URL or local development server (using paths relative to
http://localhost:5000) - Generate detailed reports including impact level, issue descriptions, help text, affected HTML elements, and failure summaries
- Integrate with Cursor's Composer via the Model Context Protocol for quick accessibility checks
- Provide code actions to fix identified accessibility violations directly within the Cursor environment
- Test using the included React application with intentional accessibility issues for practice
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.
Cursor A11y MCP
A Model Context Protocol (MCP) server that provides accessibility testing capabilities AI agents. This tool helps identify accessibility issues in web applications using axe-core and Puppeteer.
Features
- Run accessibility tests on any URL or local development server
- Powered by axe-core for comprehensive accessibility testing
- Provides detailed violation reports including:
- Impact level
- Description of the issue
- Help text and documentation links
- Affected HTML elements
- Failure summaries
Project Structure
src/- Source code for the MCP server and accessibility testing tooltest-site/- A React application with intentional accessibility issues for testingbuild/- Compiled version of the source code
Installation
Then install the test site dependencies:
Usage
Starting the MCP Server
Running the Test Site
The test site will be available at http://localhost:5000.
Running Accessibility Tests
The tool accepts two types of inputs:
- A full URL to test
- A relative path that will be appended to
http://localhost:5000
Dependencies
@modelcontextprotocol/sdk: ^1.4.1puppeteer: ^24.1.1zod: ^3.24.1
Test Site Dependencies
react: ^18.2.0react-dom: ^18.2.0react-scripts: 5.0.1
Development
- Make changes to the source code in the
src/directory - Run
npm run buildto compile the changes - Start the server with
npm start
Configuring in Cursor
To add this accessibility testing tool to Cursor's MCP Server settings:
- Open Cursor's Settings (⌘ + ,)
- Navigate to "Features" > "MCP Servers"
- Add a new MCP Server with the following configuration:
- Name:
a11y - Select
commandfrom the dropdown - Command:
node path/to/cursor-a11y-mcp/index/file/in/build/folder(Replacepath/to/cursor-a11y-mcp/index/file/in/build/folderwith the absolute path to your index.js file in the build folder.)
- Name:
- Click
Add - The accessibility testing tool will now be available in Cursor's Composer
Usage in Composer
To use the accessibility testing tool in Cursor's Composer:
- Run in your terminal:
This will start the test site at http://localhost:5000
- In Cursor's Composer, type
use a11y tool - Composer will prompt you to run the tool
- After running the tool, you will see the accessibility violations in the response, and code actions to fix the violations
- The Composer may prompt you to use the tool again to confirm that the violations are fixed
License
This project is licensed under the MIT License - see the LICENSE file for details.
Version
Current version: 2.0.1
You must be authenticated.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Provides accessibility testing capabilities through CLI, helping identify accessibility issues in web applications using axe-core and Puppeteer.
- Features
- Project Structure
- Installation
- Usage
- Dependencies
- Development
- Configuring in Cursor
- Usage in Composer
- License
- Version
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityProvides 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 -21JavaScriptMIT License
- AsecurityAlicenseAqualityEnables browser automation with Puppeteer, supporting navigation, form interactions, and connection to active Chrome instances for comprehensive web page interaction.Last updated -84708TypeScriptMIT License
- -security-license-qualityAn 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 -JavaScriptMozilla Public License 2.0