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