A11y MCP 服务器

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

特性

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

安装

# 全局安装
npm install -g a11y-mcp

# 或者直接使用 npx
npx a11y-mcp

配置

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

MCP 配置

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

{
  "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 是否有任何关键的无障碍问题”

开发

要在本地运行服务器进行开发：

npm start

发布

该项目包括一个发布脚本，以帮助版本控制和发布到 npm。该脚本处理版本号增加、运行测试、git 打标签和 npm 发布。

要发布新版本：

# 确保脚本是可执行的
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

更多信息，请运行：

./release.sh --help

许可证

MPL 2.0

致谢

该项目基于 axe-core 的出色工作构建而成