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

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

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

Функции

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

Установка

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

Использование 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

Лицензия

Массачусетский технологический институт

MCP Accessibility Scanner