a11y无障碍审计与修复MCP服务器

@priyankark/a11y-mcp

0 Stars 347 次浏览 priyankark 更新于 2026-08-23

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

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

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

可用工具（2 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

audit_webpage Perform an accessibility audit on a webpage

Perform an accessibility audit on a webpage

该工具无需必填参数，直接调用即可

get_summary Get a summary of accessibility issues for a webpage

Get a summary of accessibility issues for a webpage

该工具无需必填参数，直接调用即可

服务介绍

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

特性

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

安装

bash

全局安装

npm install -g a11y-mcp

或者直接使用 npx

npx a11y-mcp

配置

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

MCP 配置

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

json
{
"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 服务器执行无障碍审核：

"你能检查一下 example.com 的无障碍问题吗？"
"审核我的网站 https://mywebsite.com 是否符合 WCAG 2.1 AA 标准"
"给我 https://example.com 的无障碍问题摘要"
"检查我的本地开发服务器 http://localhost:3000 是否有任何关键的无障碍问题"

开发

要为开发目的在本地运行服务器：

bash
npm start

发布

该项目包括一个发布脚本，以帮助版本管理和发布到 npm。该脚本处理版本更新、运行测试、git 打标签和 npm 发布。

要发布新版本：

bash

确保脚本是可执行的

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

更多信息，请运行：

bash
./release.sh --help

许可证

MPL 2.0

致谢

本项目基于 axe-core 的优秀工作构建。

查看源码项目主页