Web Accessibility MCP Server
基于axe-core的无障碍分析MCP集成工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Web Accessibility MCP Server。 它的用途是:基于axe-core的无障碍分析MCP集成工具 完整的 Skill 内容见:https://321skill.com/skills/web-accessibility-mcp-server/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我分析 https://example.com 的无障碍问题,并给出修复建议。' 它会启动MCP服务器,加载页面,返回所有违反WCAG规则的问题,包括影响等级、元素CSS选择器和建议的修复代码。之后你可以继续追问:'把第一个问题修复后重新检测',它会自动重跑并对比结果。
介绍
网页无障碍合规是许多企业和开发者面临的刚性需求,但传统检测工具通常依赖命令行或独立浏览器插件,难以融入AI工作流。本工具将axe-core和Puppeteer封装为MCP服务器,让AI助手可以直接调用无障碍分析能力,无需手动配置扫描环境。
使用方式非常简单:在支持MCP协议的AI客户端(如Claude Desktop)中配置该服务器后,只需提供目标URL,AI便会自动启动无头浏览器加载页面,运行axe-core规则并返回详细的无障碍问题列表,包括违反的WCAG标准、影响级别、修复建议和DOM元素定位。
适合前端开发、测试工程师、QA人员以及需要确保网页可访问性的产品经理。尤其适合在CI/CD流程中集成,或与AI助手协同完成批量页面的无障碍审计。
建议优先在本地开发环境或测试环境中使用,避免对生产网站造成额外负载。由于基于Puppeteer,需要确保运行环境已安装Chromium或Chrome。对于单页应用或多框架页面,通常都能正常识别,但若页面包含大量动态加载内容,可能需要等待一定时间。
核心特点
与axe-core CLI或浏览器扩展相比,本工具以MCP服务器形式存在,可直接嵌入AI对话流程,让AI根据分析结果自动生成修复建议或代码,无需手动切换工具链。
注意事项
不支持分析需登录或复杂交互的页面,且无法检测动态变化的内容(如JS实时渲染后的状态变化)。
常见问题
如何安装依赖?
需要安装Node.js 18+,然后执行npm install;若系统缺少Chromium,Puppeteer会自动下载。你也可以设置环境变量PUPPETEER_SKIP_DOWNLOAD跳过下载。
支持哪些无障碍标准?
基于axe-core 4.x,支持WCAG 2.0、2.1、2.2的A、AA、AAA级别规则,以及部分最佳实践。你可以通过参数指定规则集。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/web-accessibility-mcp-server/raw/index.md 读取 Web Accessibility MCP Server 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/web-accessibility-mcp-server/raw/index.md(查看排版版本)