a11y-mcp

一个使用 axe-core 对网页执行可访问性审核的 MCP（模型上下文协议）服务器。将审核结果与您常用的 AI 助手（Cline/Cursor/GH Copilot）组合使用，让它们为您解决所有问题！

特征

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

安装

# Install globally
npm install -g a11y-mcp

# Or use directly with npx
npx a11y-mcp

配置

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

MCP 配置

将以下内容添加到mcpServers对象：

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

可用工具

审计网页

对网页执行详细的可访问性审核。

参数：

url （必填）：需要审核的网页的 URL
includeHtml （可选）：是否在结果中包含 HTML 片段（默认值：false）
tags （可选）：要检查的特定可访问性标签数组（例如，wcag2a，wcag2aa，wcag21a，最佳实践）

例子：

Use the a11y MCP server to audit example.com for accessibility issues

获取摘要

获取网页可访问性问题的摘要。

参数：

url （必填）：需要审核的网页的 URL

例子：

Give me an accessibility summary of example.com

示例用法

配置完成后，您可以要求 Claude 使用 MCP 服务器执行可访问性审核：

“您能检查一下 example.com 是否存在可访问性问题吗？”
“通过https://mywebsite.com审核我的网站是否符合 WCAG 2.1 AA 标准”
“请提供https://example.com上可访问性问题的摘要”
“检查我的本地开发服务器http://localhost:3000是否存在任何严重的可访问性问题”

发展

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

npm start

释放

该项目包含一个发布脚本，用于帮助进行版本控制和发布到 npm。该脚本负责处理版本升级、运行测试、git 标记以及 npm 发布。

要发布新版本：

# Make sure the script is executable
chmod +x release.sh

# Release a patch version (default)
./release.sh

# Release a minor version
./release.sh --minor

# Release a major version
./release.sh --major

# Release a specific version
./release.sh --version=1.2.3

# Skip git operations
./release.sh --skip-git

# Dry run (no changes will be made)
./release.sh --dry-run

# Force release even with uncommitted changes
./release.sh --force

要了解更多信息，请运行：

./release.sh --help

执照

MPL 2.0

致谢

该项目建立在axe-core的出色工作之上

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested