A11yScope

io.github.perceivablev0.1.2更新于 Oct 11, 2026

WCAG 2.2 AA accessibility checks for pages and HTML, run locally in headless Chrome.

已验证STDIO仅桌面Developer ToolsBrowser Automation

概览

AI 生成的概览

在本地无头 Chrome 中对网页和 HTML 片段运行 WCAG 2.2 AA 无障碍检查，并按规则返回违规项与修复建议。

功能
A11yScope 将 A11yScope Chrome 扩展所用的引擎以 MCP 服务器形式提供。scan_page 工具在无头 Chrome 中加载网址或本地 HTML 文件，按规则分组返回违规项，每项包含 CSS 选择器、HTML 片段和说明如何修改的信息。scan_html 对助手刚生成的标记执行同样检查，list_rules 则列出 31 项检查及其 WCAG 2.2 成功标准、级别、影响和修复指引。扫描选项包括需人工判断的条目、通过的检查、每条规则的发现数量上限、视口大小，以及针对延迟渲染页面的等待时间。
适用场景
适合助手编写或修改网页后、在完成前验证无障碍性的场景，例如扫描本地开发服务器并循环修复违规项。也适合检查生成的 HTML 片段中的对比度、标签、结构和 ARIA 问题。
运行要求
通过 npx 以 stdio 进程在本地运行（软件包 a11yscope-mcp）。需要 Node 20 或更高版本，以及已安装的 Chromium 系浏览器；若未找到，会一次性下载 Chrome for Testing 构建（约 150 MB）到 Puppeteer 缓存。可选环境变量 A11YSCOPE_CHROME 用于指定浏览器可执行文件。无需账户、API 密钥或网络服务。
安装前请注意
扫描在本地进行，不会上传任何内容，也没有账户或遥测。若机器上没有 Chromium 系浏览器，首次扫描可能下载 Chrome for Testing 构建。自动化检查只能覆盖部分无障碍障碍；结果不构成合规声明，需要人工判断的条目会以 review 返回，而非通过或失败。

安装

在 SourceWeft 中

  1. 打开 控制台中的 A11yScope，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

a11yscope-mcp

WCAG 2.2 AA checks for AI coding agents. The same engine as the A11yScope Chrome extension, exposed as an MCP server so Claude Code, Cursor, Claude Desktop and other MCP clients can audit the pages they build and fix what they find.

Runs locally in headless Chrome. Nothing is uploaded, no account, no telemetry.

Install

Claude Code

bash
claude mcp add a11yscope -- npx -y a11yscope-mcp

Cursor / Claude Desktop / any MCP client — add to the MCP config:

json
{  "mcpServers": {    "a11yscope": {      "command": "npx",      "args": ["-y", "a11yscope-mcp"]    }  }}

Needs Node 20 or newer and a Chromium-based browser. Installing downloads nothing: the first scan uses the Chrome, Chromium, Edge or Brave already on the machine, and only if none is found does it fetch a Chrome for Testing build (~150 MB, once) into Puppeteer's cache. To point it at a specific browser, set A11YSCOPE_CHROME to the executable path.

Tools

ToolWhat it does
scan_pageLoads a URL or a local HTML file in headless Chrome and returns violations grouped by rule, each with a CSS selector, an HTML snippet and a message that says what to change.
scan_htmlSame, for an HTML string the agent just generated. Pass base_url if the markup references stylesheets on a reachable server; otherwise inline the CSS, since contrast checks need computed styles.
list_rulesThe 31 checks, each with its WCAG 2.2 success criteria, level, impact and fix guidance.

Options on both scan tools: include_review (items that need a human decision), include_passed, max_findings_per_rule, viewport size. scan_page also takes wait_ms for pages that render late.

Typical prompt: "Scan http://localhost:3000 with a11yscope and fix every violation, then scan again."

What it checks

Text alternatives (images, form labels, buttons, links, frames, SVG), colour contrast with the large-text and bold exemptions applied and translucent backgrounds composited, document structure (language, title, headings, main landmark, skip link, tables, lists, duplicate ids), and keyboard, pointer and ARIA (zoom lock, positive tabindex, aria-hidden focusable, nested interactive controls, 24×24 target size, autoplay, captions, invalid roles, required ARIA states, autocomplete, focus visibility).

Calibrated against sites built by accessibility practitioners: gov.uk, webaim.org, deque.com, a11yproject.com and w3.org/WAI all report zero violations. Anything reported there is treated as our bug until proven otherwise, and false-positive reports are the most useful thing you can send.

What it does not do

Automated checks find roughly a third of accessibility barriers. A clean result is a good sign, not a conformance claim. Whether alt text is accurate, whether a page makes sense in a screen reader, whether a keyboard user can finish a task — no tool can answer those, and this one does not pretend to. Anything it cannot decide comes back as review, not as pass or fail. It is not a substitute for an expert evaluation and does not certify compliance with the EAA, ADA, KWCAG or any other standard.

Licence

Copyright © 2026 Perceivable. Free to install and run, including commercially, through npm and MCP clients. The engine source is published so that "nothing leaves your machine" can be verified rather than trusted; it is not open source, and no licence is granted to copy, modify or redistribute it or to publish derivative works. Full terms: the LICENSE file in this package and at the repository root. Problems and false positives: https://github.com/perceivable/a11yscope/issues.

来源：mcp/README.md，提交 c7a0aa6

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.1.2最新Oct 11, 2026