Skip to main content
Glama
deenesjakoruzh

A11y MCP Server

by ronantakizawa
npmGitHub
JavaScript
MIT License
59
28
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Web Accessibility-Testing MCP Server (A11y MCP)

a11ymcpwide

A11y MCP is an MCP (Model Context Protocol) server that gives LLMs access to web accessibility testing APIs.

This server uses the Deque Axe-core API and Puppeteer to allow LLMs to analyze web content for WCAG compliance and identify accessibility issues.

NOTE: This is not an official MCP server from Deque Labs.

Leave a star if you enjoyed the project! 🌟

Features

  • Test web pages: Test any public URL for accessibility issues
  • Test HTML snippets: Test raw HTML strings for accessibility issues
  • WCAG compliance testing: Check content against various WCAG standards (2.0, 2.1, 2.2)
  • Customizable tests: Specify which accessibility tags/standards to test against
  • Rule exploration: Get information about available accessibility rules
  • Color contrast analysis: Check color combinations for WCAG compliance
  • ARIA validation: Test proper usage of ARIA attributes
  • Orientation lock detection: Identify content that forces specific screen orientations

Installation

To use this server with Claude Desktop, you need to configure it in the MCP settings:

For macOS: Edit the file at '~/Library/Application Support/Claude/claude_desktop_config.json'

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

For Windows: Edit the file at %APPDATA%\Claude\settings\claude_mcp_settings.json

For Linux: Edit the file at ~/.config/Claude/settings/claude_mcp_settings.json Replace /path/to/axe-mcp-server/build/index.js with the actual path to your compiled server file.

Available Tools

test_accessibility

Tests a URL for accessibility issues.

Parameters:

  • url (required): The URL of the web page to test
  • tags (optional): Array of WCAG tags to test against (e.g., ["wcag2aa"])

Example

{ "url": "https://example.com", "tags": ["wcag2aa"] }

test_html_string

Tests an HTML string for accessibility issues. Parameters:

  • html (required): The HTML content to test
  • tags (optional): Array of WCAG tags to test against (e.g., ["wcag2aa"])

Example

{ "html": "<div><img src='image.jpg'></div>", "tags": ["wcag2aa"] }

get_rules

Get information about available accessibility rules with optional filtering.

check_color_contrast

Check if a foreground and background color combination meets WCAG contrast requirements.

Parameters:

  • foreground (required): Foreground color in hex format (e.g., "#000000")
  • background (required): Background color in hex format (e.g., "#FFFFFF")
  • fontSize (optional): Font size in pixels (default: 16)
  • isBold (optional): Whether the text is bold (default: false)

Example

{ "foreground": "#777777", "background": "#EEEEEE", "fontSize": 16, "isBold": false }

check_color_contrast

Check if ARIA attributes are used correctly in HTML.

Parameters:

  • html (required): HTML content to test for ARIA attribute usage

Example

{ "html": "<div role='button' aria-pressed='false'>Click me</div>" }

check_orientation_lock

Check if content forces a specific orientation.

Parameters:

  • html (required): HTML content to test for orientation lock issues

Example

{ "html": "<html><head><meta name='viewport' content='width=device-width, orientation=portrait'></head><body>Content</body></html>" }

Response Format

The server returns accessibility test results in a structured JSON format:

{ "violations": [ { "id": "color-contrast", "impact": "serious", "description": "Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds", "help": "Elements must meet minimum color contrast ratio thresholds", "helpUrl": "https://dequeuniversity.com/rules/axe/4.10/color-contrast", "affectedNodes": [ { "html": "<div style=\"color: #aaa; background-color: #eee;\">Low contrast text</div>", "target": ["div"], "failureSummary": "Fix any of the following: Element has insufficient color contrast of 1.98 (foreground color: #aaa, background color: #eee, font size: 12.0pt, font weight: normal)" } ] } ], "passes": 1, "incomplete": 0, "inapplicable": 2, "timestamp": "2025-04-25T16:45:33.655Z", "url": "about:blank", "testEngine": { "name": "axe-core", "version": "4.10.3" }, "testRunner": { "name": "axe" }, "testEnvironment": { "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/135.0.0.0 Safari/537.36", "windowWidth": 800, "windowHeight": 600, "orientationAngle": 0, "orientationType": "portrait-primary" } }

Dependencies

  • @modelcontextprotocol/sdk
  • puppeteer
  • @axe-core/puppeteer
  • axe-core
Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

Сервер MCP, позволяющий магистрам права проводить тестирование веб-доступности на соответствие стандартам WCAG с использованием API Deque Axe-core и Puppeteer.

  1. Функции
    1. Установка
      1. Доступные инструменты
        1. тест_доступности
        2. тестовая_html_строка
        3. получить_правила
        4. проверка_контраста_цвета
        5. проверка_контраста_цвета
        6. проверка_ориентации_блокировки
      2. Формат ответа
        1. Зависимости

          Related MCP Servers

          • MCP Accessibility Scanner

            JustasMonkev
            A
            security
            A
            license
            A
            quality
            Enables automated web accessibility scans for WCAG compliance using Playwright and Axe-core, providing visual and JSON reports with remediation guidance.
            Last updated -
            25
            16
            15
            MIT License

          • Web Accessibility MCP Server

            bilhasry-deriv
            A
            security
            A
            license
            A
            quality
            Provides web accessibility analysis and color blindness simulation using axe-core and Puppeteer, enabling detailed accessibility checks and visual simulations based on WCAG guidelines.
            Last updated -
            2
            3
            MIT License
            • Apple
            • Linux

          • Cursor A11y MCP

            westsideori
            A
            security
            A
            license
            A
            quality
            Provides accessibility testing capabilities through CLI, helping identify accessibility issues in web applications using axe-core and Puppeteer.
            Last updated -
            1
            1
            MIT License

          • a11y-mcp

            priyankark
            A
            security
            A
            license
            A
            quality
            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!
            Last updated -
            2
            233
            23
            Mozilla Public License 2.0

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/ronantakizawa/a11ymcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server