A11y MCP Server

这是一个使用axe-core对网页进行无障碍审计的MCP（模型上下文协议）服务器。您可以将结果与您喜欢的AI助手（如Cline/Cursor/GH Copilot）结合，在代理循环中让它们为您修复无障碍问题！

<a href="https://glama.ai/mcp/servers/@priyankark/a11y-mcp"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=822090490,2392609477&fm=3081&app=3081&f=PNG?w=760&h=400" alt="a11y-mcp MCP服务器" /> </a>

功能

• 对任何网页执行详细的无障碍审计
• 获取无障碍问题摘要
• 根据特定的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的出色工作构建。