AccesibilityHub

MCP Server for orchestrating web accessibility tools (axe-core, Pa11y, Lighthouse). Analyze web pages, check color contrast, get Lighthouse accessibility scores, and get detailed WCAG compliance reports with enriched human context.

Quick Start

npm install -g AccesibilityHub

Add to your MCP client configuration:

{
  "mcpServers": {
    "AccesibilityHub": {
      "command": "npx",
      "args": ["-y", "AccesibilityHub"]
    }
  }
}

Then ask your AI assistant:

"Analyze the accessibility of https://example.com"

Available Tools

Tool	Description	Docs
analyze-with-axe	Analyze accessibility using axe-core	docs/tools/analyze-with-axe.md
analyze-with-pa11y	Analyze accessibility using Pa11y	docs/tools/analyze-with-pa11y.md
analyze-with-lighthouse	Analyze accessibility using Lighthouse (score 0-100)	docs/tools/analyze-with-lighthouse.md
analyze-contrast	Check color contrast (WCAG 2.1 / APCA)	docs/tools/analyze-contrast.md
analyze-mixed ⭐	Run multiple tools in parallel and combine results	docs/tools/analyze-mixed.md

Available Prompts

Prompt	Description	Docs
full-accessibility-audit	Comprehensive audit using axe-core, Pa11y, and Lighthouse	docs/prompts/full-accessibility-audit.md
quick-accessibility-check	Fast check with critical issues summary	docs/prompts/quick-accessibility-check.md
contrast-check	Color contrast analysis with fix suggestions	docs/prompts/contrast-check.md
pre-deploy-check	Verify compliance with score threshold before deployment	docs/prompts/pre-deploy-check.md
quick-wins-report	High-impact, low-effort fixes from all three tools	docs/prompts/quick-wins-report.md
explain-wcag-criterion	Deep dive into any WCAG criterion	docs/prompts/explain-wcag-criterion.md
lighthouse-audit	Lighthouse score-focused accessibility audit	docs/prompts/lighthouse-audit.md
lighthouse-score-improvement	Phased plan to reach a target accessibility score	docs/prompts/lighthouse-score-improvement.md

Available Resources

Resource	Description	Docs
wcag://criteria	WCAG 2.1 criteria reference data	docs/resources/wcag-criteria.md
contrast://thresholds/*	Contrast thresholds (WCAG 2.1 / APCA)	docs/resources/contrast-thresholds.md
lighthouse://audits	Lighthouse accessibility audit catalog with WCAG mappings	docs/resources/lighthouse-audits.md

Enriched Human Context ✨

All accessibility issues include enriched context to help you understand and fix them:

• WCAG criterion explanation with real-world impact
• Affected users (screen-reader, keyboard-only, low-vision, etc.)
• Remediation priority and fix effort estimates
• Step-by-step suggested solutions

{
  "ruleId": "image-alt",
  "severity": "serious",
  "humanContext": "Non-text content (WCAG 1.1.1 - Level A)...",
  "affectedUsers": ["screen-reader", "low-vision"],
  "priority": "critical",
  "remediationEffort": "low"
}

Documentation

Document	Description
Getting Started	Installation and MCP client configuration
Tools Reference	Detailed tool documentation
Prompts Reference	Prompt templates and usage
Resources Reference	Available WCAG and contrast data
Workflows Guide	Recommended workflows
Effective Prompts	Tips for better accessibility prompts
Interpreting Results	How to prioritize and fix issues
Contributing	Project structure, development, and contributions

Requirements

• Node.js ≥ 20
• Chrome/Chromium (automatically downloaded by Puppeteer)

Support Me

If this project helps you, consider supporting its development:

License

MIT