WCAG 2.2 Compliance

wcag-compliance-mcp

用于 WCAG 2.2 审核、经验证的修复示例和美国无障碍法规截止日期的 MCP 服务。包含 4 个工具，无需 API 密钥，不进行网络调用，所有数据均已打包。

基于一项基准测试构建，并已在无头 Chromium 中验证：使用 axe-core 4.14.0 执行了 64 组失败/通过 HTML 示例，覆盖全部 87 项 WCAG 2.2 成功标准，以及从 1990 年 ADA 到 2028 年 DOJ Title II 截止日期的 21 个有来源依据的法规日期。

已列入官方 MCP 注册表，名称为 io.github.Veduis/wcag-compliance-mcp；也收录于 拥有 97k 星的 MCP 目录 和 无障碍工具列表。

工具

工具	可回答的问题
audit_html_snippet	这段 HTML 中有哪些 WCAG 2.2 缺陷？未通过的是哪项标准？修复后的样子是什么？
lookup_wcag_criterion	1.4.3 是什么意思？它属于哪个级别？是否适用于 ADA Title II 实体？是否有自动化规则？
get_verified_fix_example	展示未通过的代码片段、修正后的代码片段、问题的重要性，以及如何手动测试
check_ada_compliance_deadlines	我的组织必须在何时合规？哪个规则规定了日期？

audit_html_snippet

对片段或完整文档执行 18 项静态检查：

检查项	成功标准
图片缺少文本替代内容	1.1.1
图片按钮缺少 alt	1.1.1
role="img" SVG 缺少名称	1.1.1
链接没有可访问名称	2.4.4
按钮没有可访问名称	4.1.2
表单字段没有程序化标签	3.3.2
缺少 html lang	3.1.1
缺少页面标题	2.4.2
标题级别跳级或没有 h1	1.3.1
id 值重复	4.1.1
正数 tabindex	2.4.3
可聚焦元素上设置了 aria-hidden	4.1.2
ul/ol 中包含非 li 子元素	1.3.1
iframe 缺少 title	4.1.2
数据表格缺少 th	1.3.1
video 缺少字幕轨道	1.2.2
视口 meta 禁止缩放	1.4.4
用途常见的输入框缺少 autocomplete	1.3.5

每条发现都会返回对应标准、存在问题的标记，以及修正后的代码片段。

check_ada_compliance_deadlines

实体类型：title_ii_large、title_ii_small、title_iii_business、federal_contractor、hhs_recipient、eu_business、ontario。

传入 as_of，即可计算任意日期对应的答案，因此该工具适用于追溯性范围界定，也适用于需要说明某一天适用哪些规定的法律备忘录。每个日期都附有其主要来源 URL。

安装

npx -y github:Veduis/wcag-compliance-mcp

另外还有 3 种方式：

方式	命令
MCPB bundle（Claude Desktop，一键安装）	wcag-compliance-mcp.mcpb
官方注册表	io.github.Veduis/wcag-compliance-mcp
Docker	docker build -t wcag-compliance-mcp . && docker run -i --rm wcag-compliance-mcp

npm 包 wcag-compliance-mcp 将在下一次发布时上线。在此之前，GitHub 规格会安装相同的代码和依赖项。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "wcag-compliance": {
      "command": "npx",
      "args": ["-y", "github:Veduis/wcag-compliance-mcp"]
    }
  }
}

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "wcag-compliance": {
      "command": "npx",
      "args": ["-y", "github:Veduis/wcag-compliance-mcp"]
    }
  }
}

VS Code（Copilot Agent 模式）

.vscode/mcp.json：

{
  "servers": {
    "wcag-compliance": {
      "command": "npx",
      "args": ["-y", "github:Veduis/wcag-compliance-mcp"]
    }
  }
}

Docker

docker build -t wcag-compliance-mcp .
docker run -i --rm wcag-compliance-mcp

示例

向你的 Agent 提问：

审核此定价页面是否存在 WCAG 2.2 问题，并给出修正后的标记。

Agent 会调用 audit_html_snippet，然后针对每项未通过的标准调用 get_verified_fix_example。返回内容包括未通过的代码片段、修正后的代码片段和手动测试步骤，而不是含糊的警告。

$ audit_html_snippet('<img src="chart.png">')

{
  "summary": {
    "issues": 1,
    "checks_run": 18,
    "checks_failed": 1,
    "conformance_claim": false
  },
  "findings": [
    {
      "check_id": "img-alt",
      "sc": "1.1.1",
      "level": "A",
      "title": "Image missing a text alternative",
      "count": 1,
      "elements": [
        {
          "snippet": "<img src=\"chart.png\">",
          "reason": "No alt, aria-label, or aria-labelledby. Decorative images need alt=\"\"."
        }
      ],
      "fix": "<img src=\"chart.png\" alt=\"Bar chart: Q3 revenue rose 18 percent over Q2\">"
    }
  ]
}

自动化无法检测到的内容

这比功能列表更重要。在此服务背后的基准测试中，axe-core 4.14.0 标记了 64 份故意包含缺陷的文档中的 39 份。其余 25 份需要脚本化检查或人工审核。在完整标准中，87 项标准里有 29 项映射了规则，58 项没有；在法律实际针对的 AA 级别，24 项标准中只有 7 项有对应规则。

因此，该服务在每次审计中都会报告 conformance_claim: false。结果干净仅表示没有发现静态缺陷，并不代表页面符合标准。对比度、焦点可见性、键盘陷阱、阅读顺序、字幕准确性和错误恢复都需要渲染后的页面或人工检查。如果你需要涵盖这些检查的全域审计，vComplianceScanner 正是为此而设计的。

数据来源

数据集	DOI
预印本：自动化测试实际能检测到什么	10.5281/zenodo.23829968
64 组成对的浏览器验证失败／通过案例，axe-core 4.14.0	10.5281/zenodo.23781867
87 项带有规则映射的 WCAG 2.2 成功标准	10.5281/zenodo.23781861
21 个有来源依据的 ADA／Section 504／EAA 日期	10.5281/zenodo.23781873
64 条多轮 LLM 修复提示词	10.5281/zenodo.23781879

镜像：Hugging Face。测试用例采用 CC BY 4.0 许可，代码采用 MIT 许可。

开发

npm install
npm test          # 18 checks, including a live stdio handshake
npm start

目录结构：

src/index.mjs    MCP server, tool registration, resource
src/checks.mjs   18 static checks, no browser required
src/data.mjs     criteria, pairs, timeline, deadline resolution
data/            bundled JSON, generated from the published datasets
test/smoke.mjs   engine tests plus protocol handshake

Veduis 的更多内容

• WCAG 2.2 开发者实现手册
• ADA Title II 与 Title III：哪个法律适用于网站
• ADA 索赔函应对

许可证

代码采用 MIT 许可。数据集内容采用 CC BY 4.0 许可，须注明归属 Veduis LLC。