WCAG审计工具

用于AI编程代理的WCAG审计工具,提供HTML、文件和URL的WCAG合规性检查,支持React组件的静态HTML渲染审计。

  • by AccessLint
  • TypeScript
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 AccessLint/mcp

使用说明

此软件包保存在 访问Lint monorepo.

@accesslint/mcp

用于可访问代理编码的MCP服务器——用于AI编码代理的WCAG审计工具。建于 @接入/核心.从 访问Lint.

设置

添加到MCP客户端配置中:

{
  "mcpServers": {
    "accesslint": {
      "command": "npx",
      "args": ["@accesslint/mcp"]
    }
  }
}

工具

  • audit_html --审核HTML字符串是否存在WCAG违规。自动检测片段与完整文档。
  • 审核文件 --从磁盘读取HTML文件并对其进行审核。
  • audit_url --获取URL并审核返回的HTML。
  • diff_html --根据之前命名的审核来审核新的HTML和差异,以验证修复。
  • list_rules --按类别、级别、可修复性或标准列出可用的WCAG规则和可选过滤器。 所有审计和差异工具都接受可选 min_impact 用于按严重性过滤结果的参数。有效值,从最严重到最不严重: critical, serious, moderate, minor设置后,仅显示该级别或更高级别的违规行为。

审计输出中的每个违规都包括规则ID、CSS选择器、失败的HTML、影响级别,以及(如果可用)具体的修复建议、可修复性评级和指导。当多个元素违反同一规则时,共享元数据会打印一次,以保持输出紧凑。

鼓励

React组件审计

审计React组件(.jsx/.tsx),代理使用 audit-react-component 提示,它引导它通过:

  1. 读取组件源代码
  2. 在心理上将其渲染为静态HTML(充当 renderToStaticMarkup)
  3. 将渲染的HTML传递给 audit_html 随着 component_mode: true

不需要额外的运行时依赖关系——代理根据源代码呈现组件本身。

为什么使用这个而不是单独提示?

如果没有工具,代理会从内存中推断WCAG规则。MCP用结构化输出(特定规则ID、CSS选择器和修复建议)替换了它,因此代理直接跳过应用修复。这意味着每次运行的输出令牌减少23%,这直接转化为更快、更便宜的完成。

在25个测试用例中进行基准测试,67个可修复的违规,每个运行3次(Claude Opus):

仅使用@accesslint/mcp 代理
违规行为已修复 99.5% (200/201) 93.5% (188/201)
回归 1.7次/运行 2.0次/运行
成本 0.56美元/轮 0.62美元/轮
持续时间 270秒/次 377秒/次
超时 0/63个任务 2/63个任务

许可证

麻省理工学院