MCP Accessibility Scanner
A Model Context Protocol (MCP) server that provides automated web accessibility scanning using Playwright and Axe-core. This server enables LLMs to perform WCAG compliance checks, capture annotated screenshots, and generate detailed accessibility reports.
Features
Full WCAG 2.1/2.2 compliance checking
Automatic screenshot capture with violation highlighting
Detailed JSON reports with remediation guidance
Installation
You can install the package using any of these methods:
Using npm:
Docker Installation
The project includes a Dockerfile that sets up all necessary dependencies including Node.js v22 and Python 3.13.
- Build the Docker image:
- Run the container:
You can also run it in the background:
Installation in VS Code
Install the Accessibility Scanner in VS Code using the VS Code CLI:
For VS Code:
For VS Code Insiders:
Configuration
Here's the Claude Desktop configuration:
Usage
The scanner exposes a single tool `scan_accessibility` that accepts:
- `url`: The webpage URL to scan (required)
- `violationsTag`: Array of accessibility violation tags to check (required)
- `viewport`: Optional object to customize the viewport size - `width`: number (default: 1920) - `height`: number (default: 1080)
- `shouldRunInHeadless`: Optional boolean to control headless mode (default: true)
**Note: When running a scan, an annotated screenshot highlighting any accessibility violations will be automatically saved to your downloads folder.**
Example usage in Claude:
Advanced example with custom options:
Development
Clone and set up the project:
Start the TypeScript compiler in watch mode:
Test the MCP server locally:
Docker Development
For development using Docker:
- Build the development image:
- Run with volume mounting for live code changes:
Project Structure
License
MIT