a11y-mcp

A11y MCP Server

An 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!

Features

• Perform detailed accessibility audits on any webpage
• Get a summary of accessibility issues
• Filter audits by specific WCAG criteria
• Include HTML snippets in the results for easier debugging

Installation

Configuration

To use this MCP server with Cline, you need to add it to your MCP settings configuration file.

MCP configuration

Add the following to the mcpServers object:

Available Tools

audit_webpage

Performs a detailed accessibility audit on a webpage.

Parameters:

• url (required): URL of the webpage to audit
• includeHtml (optional): Whether to include HTML snippets in the results (default: false)
• tags (optional): Array of specific accessibility tags to check (e.g., wcag2a, wcag2aa, wcag21a, best-practice)

Example:

get_summary

Gets a summary of accessibility issues for a webpage.

Parameters:

• url (required): URL of the webpage to audit

Example:

Example Usage

Once configured, you can ask Claude to use the MCP server to perform accessibility audits:

1. "Can you check example.com for accessibility issues?"
2. "Audit my website at https://mywebsite.com for WCAG 2.1 AA compliance"
3. "Give me a summary of accessibility issues on https://example.com"
4. "Check if my local development server at http://localhost:3000 has any critical accessibility problems"

Development

To run the server locally for development:

Releasing

This project includes a release script to help with versioning and publishing to npm. The script handles version bumping, running tests, git tagging, and npm publishing.

To release a new version:

For more information, run:

License

MPL 2.0

Credits

This project builds atop the awesome work done by axe-core