A11y MCP 服务器

一个使用 axe-core 对网页进行无障碍审核的 MCP（Model Context Protocol）服务器。可以在代理循环中使用这些结果与您喜欢的 AI 助手（如 Cline/Cursor/GH Copilot）一起工作，让它们为您修复无障碍问题！

特性

• 对任何网页执行详细的无障碍审核
• 获取无障碍问题的摘要
• 按特定的 WCAG 标准筛选审核
• 在结果中包含 HTML 代码片段以便于调试

安装

bash

全局安装

npm install -g a11y-mcp

或者直接使用 npx

npx a11y-mcp

配置

要将此 MCP 服务器与 Cline 一起使用，需要将其添加到您的 MCP 设置配置文件中。

MCP 配置

在 mcpServers 对象中添加以下内容：

json { "mcpServers": { "a11y": { "command": "npx", "args": ["a11y-mcp"], "disabled": false, "autoApprove": [] } } }

可用工具

audit_webpage

对网页执行详细的无障碍审核。

参数：

• url (必需): 要审核的网页 URL
• includeHtml (可选): 是否在结果中包含 HTML 代码片段 (默认: false)
• tags (可选): 要检查的具体无障碍标签数组 (例如, wcag2a, wcag2aa, wcag21a, best-practice)

示例：

使用 a11y MCP 服务器审核 example.com 的无障碍问题

get_summary

获取网页的无障碍问题摘要。

参数：

• url (必需): 要审核的网页 URL

示例：

给我 example.com 的无障碍摘要

示例用法

配置完成后，您可以要求 Claude 使用 MCP 服务器执行无障碍审核：

1. "你能检查一下 example.com 的无障碍问题吗？"
2. "审核我的网站 https://mywebsite.com 是否符合 WCAG 2.1 AA 标准"
3. "给我 https://example.com 的无障碍问题摘要"
4. "检查我的本地开发服务器 http://localhost:3000 是否有任何关键的无障碍问题"

开发

要为开发目的在本地运行服务器：

bash npm start

发布

该项目包括一个发布脚本，以帮助版本管理和发布到 npm。该脚本处理版本更新、运行测试、git 打标签和 npm 发布。

要发布新版本：

bash

确保脚本是可执行的

chmod +x release.sh

发布补丁版本（默认）

./release.sh

发布次要版本

./release.sh --minor

发布主要版本

./release.sh --major

发布特定版本

./release.sh --version=1.2.3

跳过 git 操作

./release.sh --skip-git

干运行（不会做任何更改）

./release.sh --dry-run

即使有未提交的更改也强制发布

./release.sh --force

更多信息，请运行：

bash ./release.sh --help

许可证

MPL 2.0

致谢

本项目基于 axe-core 的优秀工作构建。