内容
="center"><a href="https://kitsunetechnologies.orgimg src="https://raw.githubusercontent.com/KitsuneTech1/.github/kitsune-banner.svg" alt="由 Kitsune Technologies 构建" width="760"></a></p>
# Kitsune 无障碍 MCP
一款由 AI 助手驱动的无障碍审计台。指向一个 URL，获取所有 2.2 违规行为，按影响程度分组，并提供修复提示在真正的无头浏览器中运行 [axe-core](https://github.com/dequelabs/axe-core)，因此它可以看到用户实际看到的页面：JavaScript 已执行，样式已应用，动态内容已渲染。然后，它添加了 axe 无法单独执行的第二次检查。
目的是让“这是否可访问？”成为一个智能体可以通过工具调用而不是猜测来回答的问题。
## 工具列表
| 工具 | 功能描述 |
|---|---|
| `a11y_audit_url` | 对实时 URL 进行 WCAG 2.2 审计，返回按影响程度排序的违规行为（优先修复关键问题），并提供故障元素和修复方法。 |
| `a11y_audit_html` | 对原始 HTML 字符串进行相同的审计部署的输出。 |
| `a11y_checklist` | 返回修复必须满足的标准： 2.2 AA 法律底线，以及之上的 14 项要求。 |
## 为什么需要额外的检查可以检测到大约三分之一的实际无障碍问题。axe-core 是其中最好的，但它仍然无法您的轮播图没有暂停按钮，或者主内容的唯一方法是遍历 40 个导航链接 axe 之上，此检查还会检查屏幕阅读器用户会立即注意到但 linter 永远不会检查
- 接近页面顶部的跳过链接 真实的 `<main>` 标志
- 任何自动移动内容的暂停控制
- 实际与关联的标签
所有关键或严重问题都必须在发布前修复。这是构建此工具的规则。
```bash
git clone https://githubitsuneTech1/kitsune-a11y.git
cd kitsune-a11y-mcp && npm install
npx playwright install chromium
```
将其注册到任何 MCP Claude Code：
claude m11y --path/to/kits11y-mcp
```
然后直接询问： *"审计 https://example.com 的无障碍性"*。
## 示例
```
> a11y_audit://example.com
2 条规则和 2 个失败。
在发布前关键/严重问题。
适 meta-viewport 不应禁用缩放和缩放
在 <meta> 上设置 user-scalable=no 会在移动设备上禁用缩放
适中 region 所有页面内容应被地标包含
KITSUNE 没有 <main> 地标
KITSUNE 在页面顶部附近没有跳过链接
```
## 注意事项
- Node 18+。Chromium 来自 `playwright-core`，因此审计是针对真正的渲染引擎运行的，而不是 DOM 模拟。
- `best_practices` 默认值为 true。将其设置为 false 以仅使用法律底线。
- 审计是只读的。它加载页面，运行检查并报告。
## 许可证
PolyForm 非商业 1.0.0 - 免费用于个人和其他非商业用途。商业用途需要从 Kitsune Technologies （Support@kitsunetechnologies.org）获取许可证。参见 [LICENSE](LICENSE)。
