mcp-a11y-service

MCP server that audits designs for WCAG 2.2 AA accessibility compliance.

Accepts two input types:

• Figma designs — via Figma MCP's get_design_context output

• Webpages — any http://, https://, or localhost URL

Both produce a markdown audit report grouped by severity, with per-violation WCAG criterion references and concrete fix recommendations.

Tools

Prompts

Requirements

• Python 3.11+

• uv or pip

Installation

pip install -r requirements.txt
playwright install chromium

axe-core is downloaded from the CDN on first run and cached locally as axe.min.js. No manual download needed.

No .env required — webpage audits run locally via Playwright, and Figma credentials live in the Figma MCP configuration.

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "a11y": {
      "command": "python",
      "args": ["/path/to/mcp-a11y-service/server.py"]
    }
  }
}

Usage with Cursor

1. Open Cursor Settings → MCP

2. Click Add new global MCP server

3. Add the following to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "a11y": {
      "command": "python",
      "args": ["/path/to/mcp-a11y-service/server.py"]
    }
  }
}

4. Restart Cursor. The a11y server will appear under Available Tools in the MCP panel.

Usage with VS Code

1. Install the Claude extension if you haven't already

2. Open your VS Code settings.json (Cmd+Shift+P → Preferences: Open User Settings (JSON))

3. Add:

{
  "claude.mcpServers": {
    "a11y": {
      "command": "python",
      "args": ["/path/to/mcp-a11y-service/server.py"]
    }
  }
}

4. Reload VS Code.

Running Tests

pytest