A11y MCP Server
MCP-Server zum Testen der Web-Zugänglichkeit (A11y MCP)
A11y MCP ist ein MCP-Server (Model Context Protocol), der LLMs Zugriff auf APIs zum Testen der Barrierefreiheit im Web gewährt.
Dieser Server verwendet die Deque Axe-Core-API und Puppeteer, um LLMs die Analyse von Webinhalten auf WCAG-Konformität und die Identifizierung von Zugänglichkeitsproblemen zu ermöglichen.
HINWEIS: Dies ist kein offizieller MCP-Server von Deque Labs.
Geben Sie einen Stern, wenn Ihnen das Projekt gefallen hat! 🌟
Merkmale
Testen Sie Webseiten : Testen Sie jede öffentliche URL auf Zugänglichkeitsprobleme
HTML-Ausschnitte testen : Testen Sie reine HTML-Zeichenfolgen auf Barrierefreiheitsprobleme
WCAG-Konformitätsprüfung : Überprüfen Sie Inhalte anhand verschiedener WCAG-Standards (2.0, 2.1, 2.2).
Anpassbare Tests : Geben Sie an, welche Zugänglichkeits-Tags/Standards getestet werden sollen
Regelerkundung : Informieren Sie sich über verfügbare Zugänglichkeitsregeln
Farbkontrastanalyse : Überprüfen Sie Farbkombinationen auf WCAG-Konformität
ARIA-Validierung : Testen Sie die ordnungsgemäße Verwendung von ARIA-Attributen
Erkennung der Ausrichtungssperre : Identifizieren Sie Inhalte, die bestimmte Bildschirmausrichtungen erzwingen
Related MCP server: @accesslint/mcp
Installation
Um diesen Server mit Claude Desktop zu verwenden, müssen Sie ihn in den MCP-Einstellungen konfigurieren:
Für macOS: Bearbeiten Sie die Datei unter '~/Library/Application Support/Claude/claude_desktop_config.json'
{
"mcpServers": {
"a11y-accessibility": {
"command": "npx",
"args": [
"-y",
"a11y-mcp-server"
]
}
}
}Für Windows: Bearbeiten Sie die Datei unter %APPDATA%\Claude\settings\claude_mcp_settings.json
Für Linux: Bearbeiten Sie die Datei unter ~/.config/Claude/settings/claude_mcp_settings.json Ersetzen Sie /path/to/axe-mcp-server/build/index.js durch den tatsächlichen Pfad zu Ihrer kompilierten Serverdatei.
Verfügbare Tools
Testzugänglichkeit
Testet eine URL auf Zugänglichkeitsprobleme.
Parameter:
url(erforderlich): Die URL der zu testenden Webseitetags(optional): Array von WCAG-Tags zum Testen (z. B. ["wcag2aa"])
Beispiel
{
"url": "https://example.com",
"tags": ["wcag2aa"]
}test_html_string
Testet einen HTML-String auf Barrierefreiheit. Parameter:
html (erforderlich): Der zu testende HTML-Inhalt
Tags (optional): Array von WCAG-Tags zum Testen (z. B. ["wcag2aa"])
Beispiel
{
"html": "<div><img src='image.jpg'></div>",
"tags": ["wcag2aa"]
}Regeln abrufen
Erhalten Sie Informationen zu verfügbaren Barrierefreiheitsregeln mit optionaler Filterung.
Farbkontrast prüfen
Überprüfen Sie, ob eine Kombination aus Vordergrund- und Hintergrundfarbe den WCAG-Kontrastanforderungen entspricht.
Parameter:
foreground(erforderlich): Vordergrundfarbe im Hex-Format (z. B. „#000000“)background(erforderlich): Hintergrundfarbe im Hex-Format (z. B. „#FFFFFF“)fontSize(optional): Schriftgröße in Pixeln (Standard: 16)isBold(optional): Ob der Text fett dargestellt wird (Standard: false)
Beispiel
{
"foreground": "#777777",
"background": "#EEEEEE",
"fontSize": 16,
"isBold": false
}Farbkontrast prüfen
Überprüfen Sie, ob ARIA-Attribute in HTML korrekt verwendet werden.
Parameter:
html(erforderlich): HTML-Inhalt zum Testen der ARIA-Attributverwendung
Beispiel
{
"html": "<div role='button' aria-pressed='false'>Click me</div>"
}check_orientation_lock
Überprüfen Sie, ob der Inhalt eine bestimmte Ausrichtung erzwingt.
Parameter:
html(erforderlich): HTML-Inhalt zum Testen auf Probleme mit der Orientierungssperre
Beispiel
{
"html": "<html><head><meta name='viewport' content='width=device-width, orientation=portrait'></head><body>Content</body></html>"
}Antwortformat
Der Server gibt die Ergebnisse des Zugänglichkeitstests in einem strukturierten JSON-Format zurück:
{
"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"
}
}Abhängigkeiten
@modelcontextprotocol/sdk
Puppenspieler
@axe-core/puppeteer
Axtkern
Available Tools
6 toolscheck_aria_attributesC
Check if ARIA attributes are used correctly in HTML
Inputs: html (required).
check_color_contrastA
Check if a foreground and background color combination meets WCAG contrast requirements
Inputs: background (required), foreground (required), fontSize, isBold.
check_orientation_lockC
Check if content forces a specific orientation
Inputs: html (required).
get_rulesC
Get information about available accessibility rules with optional filtering
Inputs: tags.
test_accessibilityC
Test a webpage for accessibility issues using Axe-core
Inputs: url (required), tags.
test_html_stringB
Test an HTML string for accessibility issues
Inputs: html (required), tags.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: checking specific ARIA attributes, color contrast, orientation lock, retrieving rule information, testing webpages, and testing HTML strings. There is no overlap or ambiguity between these functions, making tool selection straightforward for an agent.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., check_aria_attributes, test_accessibility). This predictability enhances readability and usability without any deviations or mixed conventions.
With 6 tools, the server is well-scoped for accessibility testing, covering key areas like ARIA, color contrast, orientation, rule retrieval, and testing methods. Each tool earns its place without feeling thin or bloated, aligning perfectly with the domain's needs.
The toolset provides comprehensive coverage for accessibility testing, including specific checks, rule information, and testing capabilities. A minor gap exists in lacking explicit tools for remediation or detailed reporting, but core workflows are fully supported, allowing agents to work effectively.
Maintenance
Related MCP Connectors
MCP server providing access to the Scorecard API to evaluate and optimize LLM systems.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Cloudflare Workers MCP server: a11y-scorer
Related MCP Servers
- AlicenseBqualityBmaintenanceAn 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!2592 npm53Mozilla Public 2.0

@accesslint/mcpofficial
AlicenseAqualityFmaintenanceAn MCP server for WCAG accessibility auditing in AI coding agents, providing tools to audit HTML, files, URLs, and diffs, plus a prompt for React component auditing.52,488 npm6MIT- AlicenseNot gradedqualityBmaintenanceAn MCP server that lets an AI agent scan a web page for WCAG accessibility issues and get back findings it can act on.282 npmMIT
- AlicenseAqualityDmaintenanceMCP server for axe-core accessibility audits. Enables scanning URLs or HTML for WCAG violations with impact levels and fix guidance.42MIT