Сканер доступности MCP 🔍

Name: MCP Accessibility Scanner
Author: JustasMonkev

Сервер Model Context Protocol (MCP), который обеспечивает автоматическое сканирование веб-доступности с использованием Playwright и Axe-core. Этот сервер позволяет LLM выполнять проверки соответствия WCAG, делать аннотированные снимки экрана и генерировать подробные отчеты о доступности.

Функции

✅ Полная проверка соответствия WCAG 2.1/2.2
🖼️ Автоматический снимок экрана с выделением нарушений
📄 Подробные отчеты JSON с рекомендациями по устранению неполадок

Related MCP server: Cursor A11y MCP

Установка

Вы можете установить пакет любым из этих способов:

Использование npm:

npm install -g mcp-accessibility-scanner

Установка докера

Проект включает Dockerfile, который устанавливает все необходимые зависимости, включая Node.js v22 и Python 3.13.

Создайте образ Docker:

docker build -t mcp-server .

Запустите контейнер:

docker run -it -e MCP_PROXY_DEBUG=true mcp-server

Вы также можете запустить его в фоновом режиме:

docker run -d -p 3000:3000 mcp-server

Установка в VS Code

Установите сканер доступности в VS Code с помощью VS Code CLI:

Для VS-кода:

code --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'

Для инсайдеров VS Code:

code-insiders --add-mcp '{"name":"accessibility-scanner","command":"npx","args":["mcp-accessibility-scanner"]}'

Конфигурация

Вот конфигурация Claude Desktop:

{ "mcpServers": { "accessibility-scanner": { "command": "npx", "args": ["-y", "mcp-accessibility-scanner"] } } }

Использование

Сканер предоставляет единственный инструмент scan_accessibility , который принимает:

url : URL-адрес веб-страницы для сканирования (обязательно)
violationsTag : Массив тегов нарушения доступности для проверки (обязательно)
viewport : Необязательный объект для настройки размера области просмотра.
- width : число (по умолчанию: 1920)
- height : число (по умолчанию: 1080)
shouldRunInHeadless : необязательное логическое значение для управления режимом headless (по умолчанию: true)

Примечание: при запуске сканирования аннотированный снимок экрана, на котором отмечены любые нарушения доступности, будет автоматически сохранен в папке загрузок.

Пример использования в Клоде:

Could you scan example.com for accessibility issues related to color contrast?

Расширенный пример с пользовательскими параметрами:

Could you scan example.com for accessibility issues with a viewport of 1280x720 and show the browser window?

Разработка

Клонируйте и настройте проект:

git clone https://github.com/JustasMonkev/mcp-accessibility-scanner.git cd mcp-accessibility-scanner npm install

Запустите компилятор TypeScript в режиме наблюдения:

npm run watch

Протестируйте сервер MCP локально:

npm run inspector

Разработка Докера

Для разработки с использованием Docker:

Создайте образ разработки:

docker build -t mcp-server-dev .

Запустите с монтированием тома для оперативного изменения кода:

docker run -it -v $(pwd):/app -p 3000:3000 -e MCP_PROXY_DEBUG=true mcp-server-dev

Структура проекта

├── src/ # Source code │ ├── index.ts # MCP server setup and tool definitions │ └── scanner.ts # Core scanning functionality ├── build/ # Compiled JavaScript output ├── Dockerfile # Docker configuration for containerized setup ├── package.json # Project configuration and dependencies └── tsconfig.json # TypeScript configuration