Cursor A11y MCP

Cursor A11y MCP

site icon
2025.03.12 0
JavaScript网页可访问性测试自动化测试浏览器自动化开发效率
Cursor A11y MCP 是一个基于 Model Context Protocol (MCP) 的服务,专注于为 AI 代理提供网页可访问性测试能力。该工具利用 axe-core 和 Puppeteer 来识别网页应用中的可访问性问题,并提供详细的违规报告。
View on GitHub

Overview

基本能力

产品定位

Cursor A11y MCP 是一个专注于网页可访问性测试的工具,旨在帮助开发者和 AI 代理识别和修复网页中的可访问性问题。

核心功能

  • 运行对任何 URL 或本地开发服务器的可访问性测试
  • 使用 axe-core 进行全面的可访问性测试
  • 提供详细的违规报告,包括:
  • 影响级别
  • 问题描述
  • 帮助文本和文档链接
  • 受影响的 HTML 元素
  • 失败摘要

适用场景

  • 开发过程中检测网页的可访问性问题
  • 自动化测试流程中集成可访问性测试
  • AI 代理辅助开发时提供可访问性反馈

工具列表

  • axe-core: 用于执行可访问性测试的核心引擎
  • Puppeteer: 用于控制浏览器并加载网页进行测试

常见问题解答

  • 如何配置 Cursor 以使用此工具?
  • 打开 Cursor 的设置
  • 导航到 "Features" > "MCP Servers"
  • 添加一个新的 MCP Server,选择 command 并指定工具的路径

使用教程

使用依赖

npm install
cd test-site
npm install
cd ..

安装教程

npm run build
npm start

调试方式

npm run start:test-site

测试站点将在 http://localhost:5000 上可用。

开发

  1. src/ 目录中修改源代码
  2. 运行 npm run build 编译更改
  3. 使用 npm start 启动服务器

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。