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
npm install
Then install the test site dependencies:
cd test-site
npm install
cd ..
Usage
Starting the MCP Server
npm run build
npm start
Running the Test Site
npm run start: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:
npm run start:test-site
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