Cursor A11y MCP
集成axe-core与Puppeteer的网页可访问性测试开发工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Cursor A11y MCP。 它的用途是：集成axe-core与Puppeteer的网页可访问性测试开发工具 完整的 Skill 内容见：https://321skill.com/skills/cursor-a11y-mcp/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用Cursor A11y MCP测试当前项目的登录页面，并生成一份可访问性报告。”，它会调用该工具，启动一个无头浏览器加载指定页面，运行axe-core分析引擎，并将检测到的违规项（如低对比度文本、缺失的alt属性）以结构化的报告形式返回给你，方便定位和修复问题。
介绍
Cursor A11y MCP 是一款专注于解决网页可访问性（A11y）测试问题的开发工具。它旨在帮助开发者在开发阶段及时发现并修复网页中存在的无障碍访问障碍，确保网站或应用能够被所有用户，包括残障人士，顺利使用。
该工具通过将业界领先的自动化可访问性测试引擎 axe-core 与浏览器自动化框架 Puppeteer 进行深度集成，实现了在开发流程中对网页进行自动化、可编程的无障碍测试。开发者可以通过编写脚本，在构建流程或本地开发环境中自动运行测试，并获取详细的违规报告。
它非常适合前端开发、全栈开发和测试工程师，尤其是在开发需要遵循WCAG（Web内容可访问性指南）等标准的公共网站、企业级应用或政府项目时使用。对于关注产品包容性和合规性的产品经理同样具有参考价值。
使用建议是将其集成到CI/CD流水线中，作为代码提交前的质量门禁。需要注意的是，自动化测试无法覆盖所有可访问性问题（如逻辑顺序、语义理解），因此仍需结合手动测试和辅助技术（如屏幕阅读器）进行综合评估。
核心特点
与单纯提供可访问性检查报告的工具不同，它深度集成Puppeteer，允许开发者以编程方式控制浏览器，对动态渲染的单页应用（SPA）或需要交互后才能暴露问题的复杂页面进行精准测试。同时，它作为MCP工具，可以更灵活地嵌入到基于Cursor等AI编码助手的开发工作流中。
注意事项
主要依赖axe-core的规则集，无法检测所有类型（尤其是需要人工逻辑判断）的可访问性问题，且测试深度受限于Puppeteer脚本的覆盖范围。
常见问题
这个工具能检测哪些可访问性问题？
基于axe-core规则集，可检测颜色对比度、ARIA属性、键盘导航、语义化标签、表单标签关联等数百种常见可访问性违规。
它支持测试需要登录或复杂交互的页面吗？
支持。通过Puppeteer脚本，可以模拟登录、点击、输入等完整用户交互流程，再对交互后的页面状态进行可访问性分析。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/cursor-a11y-mcp/raw/index.md 读取 Cursor A11y MCP 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/cursor-a11y-mcp/raw/index.md（查看排版版本）