accessibilitymcp

为LLM提供网页无障碍测试能力的MCP服务器。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:accessibilitymcp。
它的用途是:为LLM提供网页无障碍测试能力的MCP服务器。
完整的 Skill 内容见:https://321skill.com/skills/accessibilitymcp/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“请帮我测试一下 https://example.com 首页的无障碍合规情况。”,它会调用该Skill,启动浏览器访问该页面,运行Axe-core测试,并返回一份结构化的报告,列出发现的所有错误、警告以及对应的WCAG准则和修复建议。

介绍

这个Skill旨在解决开发者和测试人员在网页开发过程中,难以快速、自动化地评估网站是否符合无障碍(Accessibility)标准的问题。它通过集成业界知名的Deque Axe-core测试引擎和Puppeteer浏览器自动化工具,让AI助手能够直接对指定网页进行全面的无障碍合规性扫描。

使用时,你需要通过MCP协议将这个服务器连接到你的AI助手(如Claude Desktop)。之后,你可以直接向AI助手提出测试某个网页无障碍性的请求,AI会调用该Skill,自动打开网页、运行测试并返回详细的检测报告,包括发现的问题、严重程度以及修复建议。

它非常适合前端开发、测试工程师以及产品经理等角色。前端开发者可以在开发过程中即时检查代码的无障碍性;测试工程师可以将其集成到自动化测试流程中;产品经理则能快速评估产品原型或线上页面的合规风险。

建议在网页开发的关键节点(如提测前、上线前)使用此Skill进行快速检查。需要注意的是,自动化测试无法覆盖所有用户场景(如复杂的键盘导航逻辑),其结果应作为重要参考,并结合人工测试共同确保无障碍体验。

核心特点

与仅提供代码片段分析的无障碍工具不同,此Skill通过Puppeteer模拟真实浏览器环境运行Axe-core,能检测到依赖完整DOM渲染和交互的动态内容问题;同时,它将专业测试能力封装为MCP服务,让LLM成为可直接操作的无障碍测试助手,而非仅仅输出工具使用指南。

注意事项

不适合测试需要复杂登录状态、包含大量不可访问Iframe或重度依赖视觉验证(如颜色对比度细微差别)的页面场景。

常见问题

这个工具能检测哪些无障碍问题?

能检测Axe-core支持的标准,如ARIA属性错误、颜色对比度不足、键盘导航缺失、图片缺少Alt文本等WCAG常见违规项。

需要自己部署Puppeteer和浏览器环境吗?

是的,你需要确保运行环境中已安装Node.js、Puppeteer及其所需的Chrome/Chromium浏览器。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/accessibilitymcp/raw/index.md 读取 accessibilitymcp 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。