Web Accessibility MCP Server
MCP-Server für Web-Zugänglichkeit
Ein MCP-Server (Model Context Protocol), der mithilfe von Axe-Core und Puppeteer Funktionen zur Analyse der Webzugänglichkeit bereitstellt.
Merkmale
Analysieren Sie die Webzugänglichkeit beliebiger URLs mit axe-core
Simulieren Sie Farbenblindheit (Protanopie, Deuteranopie, Tritanopie) mithilfe von Farbmatrizen
Detaillierte Berichterstattung über Barrierefreiheitsverletzungen
Unterstützung für benutzerdefinierte Benutzeragenten und Selektoren
Debug-Protokollierung zur Fehlerbehebung
Umfassende Barrierefreiheitsprüfungen basierend auf den WCAG-Richtlinien
Related MCP server: Cursor A11y MCP
Voraussetzungen
Node.js (v14 oder höher)
npm
Installation
Installation über Smithery
So installieren Sie den Web Accessibility MCP Server für Claude Desktop automatisch über Smithery :
npx -y @smithery/cli install @bilhasry-deriv/mcp-web-a11y --client claudeManuelle Installation
Klonen Sie das Repository:
git clone [repository-url]
cd mcp-web-a11yInstallieren Sie Abhängigkeiten:
npm installErstellen Sie den Server:
npm run buildKonfiguration
Fügen Sie den Server zu Ihrer MCP-Einstellungsdatei hinzu (normalerweise unter ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):
{
"mcpServers": {
"web-a11y": {
"command": "node",
"args": ["/path/to/mcp-web-a11y/build/index.js"],
"disabled": false,
"autoApprove": [],
"env": {
"MCP_OUTPUT_DIR": "/path/to/output/directory"
}
}
}
}Umgebungsvariablen
MCP_OUTPUT_DIR: Verzeichnis, in dem Screenshot-Ausgaben gespeichert werdenErforderlich für das Tool
simulate_colorblindWenn nicht angegeben, wird standardmäßig „./output“ relativ zum aktuellen Arbeitsverzeichnis verwendet.
Muss ein absoluter Pfad sein, wenn in den MCP-Einstellungen konfiguriert
Verwendung
Der Server bietet zwei Tools: check_accessibility zur Analyse der Webzugänglichkeit und simulate_colorblind zur Simulation von Farbenblindheit.
Werkzeug: check_accessibility
Überprüft die Erreichbarkeit einer bestimmten URL mithilfe von Axe-Core.
Parameter
url(erforderlich): Die zu analysierende URLwaitForSelector(optional): CSS-Selektor, auf den vor der Analyse gewartet werden solluserAgent(optional): Benutzerdefinierter User-Agent-String für die Anfrage
Beispielverwendung
<use_mcp_tool>
<server_name>mcp-web-a11y</server_name>
<tool_name>check_accessibility</tool_name>
<arguments>
{
"url": "https://example.com",
"waitForSelector": ".main-content",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
}
</arguments>
</use_mcp_tool>Werkzeug: simulate_colorblind
Simuliert mithilfe von Farbmatrixtransformationen, wie eine Webseite Benutzern mit unterschiedlichen Arten von Farbenblindheit angezeigt wird.
Arten der Farbenblindheit
Das Tool unterstützt drei Arten der Farbenblindheitssimulation:
Protanopie (Rotblindheit) – Verwendet Matrix:
0.567, 0.433, 0 0.558, 0.442, 0 0, 0.242, 0.758Deuteranopie (Grünblindheit) – Verwendet Matrix:
0.625, 0.375, 0 0.7, 0.3, 0 0, 0.3, 0.7Tritanopie (Blaublindheit) – Verwendet Matrix:
0.95, 0.05, 0 0, 0.433, 0.567 0, 0.475, 0.525
Parameter
url(erforderlich): Die zu erfassende URLtype(erforderlich): Zu simulierender Typ der Farbenblindheit („Protanopie“, „Deuteranopie“ oder „Tritanopie“)outputPath(optional): Benutzerdefinierter Pfad für die Screenshot-AusgabeuserAgent(optional): Benutzerdefinierter User-Agent-String für die Anfrage
Beispielverwendung
<use_mcp_tool>
<server_name>mcp-web-a11y</server_name>
<tool_name>simulate_colorblind</tool_name>
<arguments>
{
"url": "https://example.com",
"type": "deuteranopia",
"outputPath": "colorblind_simulation.png"
}
</arguments>
</use_mcp_tool>Antwortformat
check_accessibility-Antwort
{
"url": "analyzed-url",
"timestamp": "ISO-timestamp",
"violations": [
{
"impact": "serious|critical|moderate|minor",
"description": "Description of the violation",
"help": "Help text explaining the issue",
"helpUrl": "URL to detailed documentation",
"nodes": [
{
"html": "HTML of the affected element",
"failureSummary": "Summary of what needs to be fixed"
}
]
}
],
"passes": 42,
"inapplicable": 45,
"incomplete": 3
}simulate_colorblind Antwort
{
"url": "analyzed-url",
"type": "colorblind-type",
"outputPath": "path/to/screenshot.png",
"timestamp": "ISO-timestamp",
"message": "Screenshot saved with [type] simulation"
}Fehlerbehandlung
Der Server umfasst eine umfassende Fehlerbehandlung für gängige Szenarien:
Netzwerkfehler
Ungültige URLs
Timeout-Probleme
Probleme mit der DNS-Auflösung
Fehlerantworten enthalten ausführliche Meldungen zur Unterstützung der Problemdiagnose.
Entwicklung
Projektstruktur
mcp-web-a11y/
├── src/
│ └── index.ts # Main server implementation
├── build/ # Compiled JavaScript
├── output/ # Generated screenshots
├── package.json # Project dependencies and scripts
└── tsconfig.json # TypeScript configurationGebäude
npm run buildDies wird:
Kompilieren Sie TypeScript in JavaScript
Machen Sie die Ausgabedatei ausführbar
Platzieren Sie die kompilierten Dateien im
buildVerzeichnis
Debuggen
Der Server verfügt über eine detaillierte Debug-Protokollierung, die in der Konsolenausgabe angezeigt wird. Dazu gehören:
Netzwerkanfragen und -antworten
Seitenladestatus
Selektor-Wartestatus
Alle Konsolenmeldungen von der analysierten Seite
Fortschritt der Farbsimulation
Häufige Probleme und Lösungen
Timeout-Fehler
Erhöhen Sie den Timeout-Wert im Code
Überprüfen der Netzwerkkonnektivität
Überprüfen Sie, ob die URL zugänglich ist
DNS-Auflösungsfehler
Überprüfen Sie, ob die URL korrekt ist
Überprüfen der Netzwerkkonnektivität
Versuchen Sie es mit der Subdomäne www
Selektor nicht gefunden
Überprüfen Sie, ob der Selektor auf der Seite vorhanden ist.
Warten Sie, bis der dynamische Inhalt geladen ist
Überprüfen Sie die Seitenquelle auf den richtigen Selektor
Probleme mit der Farbsimulation
Stellen Sie sicher, dass die Farben der Seite in einem unterstützten Format (RGB, RGBA oder HEX) angegeben sind.
Prüfen Sie, ob die Seite dynamische Farbänderungen verwendet (möglicherweise ist zusätzliche Wartezeit erforderlich).
Überprüfen Sie, ob das Screenshot-Ausgabeverzeichnis vorhanden und beschreibbar ist.
Beitragen
Forken Sie das Repository
Erstellen eines Feature-Zweigs
Übernehmen Sie Ihre Änderungen
Push zum Zweig
Erstellen einer Pull-Anforderung
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .
Available Tools
2 toolscheck_accessibilityC
Check web accessibility of a given URL using axe-core
Inputs: url (required), waitForSelector, userAgent.
simulate_colorblindC
Simulate how a webpage looks for colorblind users
Inputs: url (required), type (required), outputPath, userAgent.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one checks general web accessibility using axe-core, while the other specifically simulates colorblindness effects on a webpage. There is no overlap or ambiguity between them.
Both tools follow a consistent verb_noun pattern (check_accessibility, simulate_colorblind) with clear, descriptive names. The naming style is uniform and predictable throughout the set.
With only two tools, the server feels thin for a web accessibility domain. While the tools are useful, typical accessibility testing involves more operations like checking screen reader compatibility, keyboard navigation, or ARIA attributes, suggesting notable gaps in coverage.
The tool set is severely incomplete for web accessibility. It lacks core operations such as validating HTML structure, testing screen reader output, assessing keyboard accessibility, or generating accessibility reports, which are essential for comprehensive accessibility evaluation.
Maintenance
Related MCP Connectors
Scan URLs or HTML for WCAG 2.2 violations. 75-rule manifest, weighted score, shareable reports.
Deterministic axe-core accessibility scans (WCAG 2.1 AA, EN 301 549, PDF/UA) via your account.
Scan URLs for WCAG 2.1 violations, generate AI fixes, and produce VPAT 2.5 compliance reports.
Accessibility pre-checks (WCAG/BFSG) in a real browser + statement drafts. Pay per call.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables automated web accessibility scans for WCAG compliance using Playwright and Axe-core, providing visual and JSON reports with remediation guidance.252,963 npm59MIT
- AlicenseBqualityDmaintenanceProvides accessibility testing capabilities through CLI, helping identify accessibility issues in web applications using axe-core and Puppeteer.12MIT
- AlicenseBqualityDmaintenanceEnables AI agents to perform comprehensive accessibility audits on websites using Playwright and axe-core against WCAG standards. Provides detailed compliance reports with violation summaries and remediation guidance across multiple browsers.3MIT
- AlicenseNot gradedqualityDmaintenancePerforms automated web accessibility audits following WCAG standards using axe-core and Puppeteer, generating detailed reports in Spanish with recommended solutions and code examples.MIT