A11y MCP 服务器

一个使用 axe-core 进行网页可访问性审核的 Model Context Protocol (MCP) 服务器。与您最喜欢的 AI 助手（Cline/Cursor/GH Copilot）结合使用，并让它们为您修复可访问性问题！

功能

• 对任何网页执行详细的可访问性审核
• 获取可访问性问题摘要
• 按特定 WCAG 标准过滤审核结果
• 在结果中包含 HTML 片段以方便调试

安装

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

# 或直接使用 npx
npx a11y-mcp

配置

要与 Cline 一起使用此 MCP 服务器，需将其添加到您的 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 构建