accessibility-scanner-mcp

accessibility-scanner-mcp

一个 MCP 服务，可让 AI Agent 扫描网页中的 WCAG 无障碍问题，并返回可供其处理的发现结果。Agent 只需调用一个工具并提供 URL；工具就会按严重程度归类所有违规项，每项都包含准确的元素选择器、存在问题的 HTML、具体失败原因、WCAG 成功标准以及修复指南链接，此外还会列出仍需人工审核的项目。

它会在你的本地 Chrome 中运行真正的 axe-core 引擎（通过 playwright-core），因此你扫描的页面不会离开你的设备。它会先滚动页面，确保实际检查延迟加载的内容，而不是悄无声息地跳过；它还会解析 CSS 渐变背景上的颜色对比度，而大多数工具会将其标为“需要审核”。

从 0.1.x 升级？ 0.2.0 能检查每个页面的更多内容，并会针对同一 URL 返回更多发现结果。 参见 CHANGELOG.md。

隶属于 accessibilityscanner.app。

要求

• Node.js 18+
• 基于 Chromium 的浏览器：Chrome、Chromium 或 Edge，按此顺序自动查找。 如果想指定浏览器，请将 CHROME_PATH 设置为特定二进制文件的路径。作为最后的选择，会使用 Playwright 已安装的浏览器；不会为你下载任何内容。

或者完全不需要浏览器

设置 SCANNER_API_URL，扫描就会在 accessibilityscanner.app 上运行，而不是在本地运行：

{ "env": { "SCANNER_API_URL": "https://accessibilityscanner.app" } }

无需账户或密钥——它使用的网站表单也使用相同的公共端点。 适用于 CI、容器，或任何无法安装浏览器的环境。托管扫描还会为对比度失败项提供建议的修复颜色，本地扫描器目前尚无法计算这些颜色。

⚠️ 在此模式下，你扫描的 URL 会发送到我们的服务器。本地模式不会将任何内容发送到其他位置，并且仍是默认模式——只有通过该环境变量才能选择启用托管模式。

安装

将它添加到 MCP 客户端的配置中。无需全局安装——首次运行时，npx 会获取它。

Claude Desktop（claude_desktop_config.json）、Cursor、Claude Code 或任何 MCP 客户端：

{
  "mcpServers": {
    "accessibility-scanner": {
      "command": "npx",
      "args": ["-y", "accessibility-scanner-mcp"]
    }
  }
}

如果未自动检测到 Chrome，请添加一个 env 块：

{
  "mcpServers": {
    "accessibility-scanner": {
      "command": "npx",
      "args": ["-y", "accessibility-scanner-mcp"],
      "env": { "CHROME_PATH": "/usr/bin/google-chrome" }
    }
  }
}

工具

scan_accessibility

输入
url（字符串，必填）	要扫描的 http(s) URL。

返回按严重程度分组的报告。对于每条规则，报告会提供 WCAG 成功标准、修复指南链接，以及每个元素的选择器、HTML 和确切失败原因。与 Agent 的示例流程：

你： 审核 https://example.com 的无障碍情况，并修复你能修复的问题。 Agent： （调用 scan_accessibility） → 阅读发现结果 → 编辑代码 → 重新扫描。

如实说明限制

自动化测试只能覆盖 WCAG 中可通过机器检查的部分（典型页面上的大多数问题，但并非全部）。需要人工判断的项目会列在“需要人工审核”下。它绝不会声称某个页面“符合规范”。

许可证

MIT