A11y MCP

A11y MCP服务器

MCP（模型上下文协议）服务器，用于使用axe-core对网页执行可访问性审计。在代理循环中使用您最喜欢的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": []
    }
  }
}

可用工具

audit_网页

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

参数：

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

例子：

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

get_summary

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

参数：

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

例子：

Give me an accessibility summary of 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发布。

要发布新版本，请执行以下操作：

# 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

鸣谢

这个项目建立在以下出色工作的基础上 斧头核心