使用说明
wcag mcp
WCAG MCP代理系统服务器 -由W3C官方数据和全面理解文档提供支持
模型上下文协议（MCP）服务器，提供对WCAG 2.2指南、技术、术语表术语和 完整的理解文档 对于每一个成功标准。可在本地（stdio）和远程（Netlify Functions）工作。
快速开始
添加到MCP客户端配置中：
{
"mcpServers": {
"wcag": {
"command": "npx",
"args": ["-y", "wcag-guidelines-mcp"]
}
}
}
就是这样！无需克隆，无需构建——只需添加配置并开始查询WCAG。
特性
- 完成WCAG 2.2覆盖 -全部87个成功标准，详细信息
- 完全理解文档 -每个SC的意图、利益、示例和资源
- 技术库 -400多种技术（充分、咨询、故障模式）
- 词汇表 -101 WCAG官方术语定义
- 版本跟踪 -查看WCAG 2.2的新增功能
新增内容：了解文档
此服务器现在包括 完整的理解文档 从W3C WCAG官方理解文档中解析。对于每一个成功标准，你都会得到：
- 简要概述 -目标、要做什么以及为什么重要
- 意图 -目的和基本原理的详细解释
- 益处 -谁受益以及如何受益
- 例子 -现实世界中的实施实例
- 资源 -整理好的工具和参考文献清单
不再关注外部链接-您需要的一切都在MCP响应中！
可用工具（共20个）
特性
- 完成WCAG 2.2覆盖 -全部87个成功标准，详细信息
- 完全理解文档 -每个SC的意图、利益、示例和资源
- 技术库 -400多种技术（充分、咨询、故障模式）
- ACT考试规则 -87+标准化无障碍测试规则
- 词汇表 -101 WCAG官方术语定义
- 版本跟踪 -查看WCAG 2.2的新增功能
新增内容：了解文档
此服务器现在包括 完整的理解文档 从W3C WCAG官方理解文档中解析。对于每一个成功标准，你都会得到：
- 简要概述 -目标、要做什么以及为什么重要
- 意图 -目的和基本原理的详细解释
- 益处 -谁受益以及如何受益
- 例子 -现实世界中的实施实例
- 资源 -整理好的工具和参考文献清单
不再关注外部链接-您需要的一切都在MCP响应中！
可用工具（共20个）
核心WCAG工具
| 工具 | 说明 |
|---|---|
list-principles |
列出所有四个WCAG 2.2原则（可感知、可操作、可理解、稳健） |
list-guidelines |
列出WCAG 2.2指南，可选择按原则编号（1-4）过滤 |
list-success-criteria |
按级别（A/AA/AAA）、指南或原则列出带有可选过滤器的成功标准 |
get-success-criteria-detail |
只获取规范的成功标准文本和异常，而不需要理解文档 |
get-criterion |
获取全面的详细信息，包括完整的理解文档（意图、好处、示例） |
get-guideline |
获取特定指南的完整详细信息，包括其所有成功标准 |
search-wcag |
按标题和描述中的关键字搜索成功标准 |
get-criteria-by-level |
获取一致性级别的所有条件，可选地包括较低级别 |
count-criteria |
返回按级别、原则或指南分组的成功标准计数 |
技术工具
| 工具 | 说明 |
|---|---|
list-techniques |
列出技术，按技术（html、aria、css、pdf、通用）或类型过滤 |
get-technique |
通过ID获取特定技术的详细信息（例如，“H37”、“ARIA1”、“G94”） |
get-techniques-for-criterion |
获取成功标准的所有技术（充分、建议、失败） |
search-techniques |
按关键字搜索技术 |
get-failures-for-criterion |
获取成功标准的失败模式（常见错误） |
术语表工具
| 工具 | 说明 |
|---|---|
get-glossary-term |
获取WCAG术语的定义（例如，“编程确定”） |
list-glossary-terms |
列出所有101个WCAG术语表 |
search-glossary |
按关键字搜索术语表 |
增强的上下文工具
| 工具 | 说明 |
|---|---|
whats-new-in-wcag22 |
列出WCAG 2.2中添加的所有9个成功标准 |
get-full-criterion-context |
获取全面的上下文：SC+技术 |
get-server-info |
返回服务器信息和统计信息 |
数据源
此服务器使用来自 W3C WCAG知识库:
- WCAG JSON: 已发布WCAG 2.2 JSON
- 理解文档：从子模块中的官方W3C理解HTML文件解析而来
统计
- 4原则 -可感知、可操作、可理解、坚固
- 13指南 -根据原则组织
- 87成功标准 -A级（32）、AA级（24）、AAA级（31）
- 400+技术 -HTML、ARIA、CSS、PDF、通用等
- 101术语表 -WCAG官方定义
安装
# Clone with submodules
git clone --recurse-submodules https://github.com/joe-watkins/wcag-mcp.git
cd wcag-mcp
# Install dependencies and build data (automatically fetches WCAG data and Understanding docs)
npm install
更新WCAG数据
要获取最新的WCAG数据和了解文档：
# Update submodule, fetch latest data from W3C, and parse Understanding docs
npm run build
构建过程：
- 将W3C WCAG git子模块更新到最新版本
- 从W3C获取最新的WCAG 2.2 JSON数据
- 从HTML文件解析所有理解文档
这将在以下期间自动运行 npm install.
配置IDE
将此添加到您的Claude Desktop MCP设置中：
{
"mcpServers": {
"wcag-mcp": {
"command": "node",
"args": ["<path to installed mcp>/wcag-mcp/src/index.js"]
}
}
}
部署到Netlify
此项目配置为部署为Netlify功能。
通过GitHub部署
- 将此存储库推送到GitHub
- 通过Netlify仪表板将其连接到Netlify
- Netlify将自动构建和部署
使用远程服务器
部署后，配置您的Claude Desktop MCP设置以使用远程服务器：
{
"mcpServers": {
"wcag-mcp": {
"type": "stdio",
"command": "npx",
"args": ["mcp-remote@next", "https://your-site.netlify.app/mcp"]
}
}
}
替换 your-site.netlify.app 使用您的实际Netlify URL。
项目结构
wcag-mcp/
├── data/
│ ├── wcag/ # W3C WCAG submodule (includes Understanding docs)
│ │ └── understanding/ # Understanding HTML files by WCAG version
│ │ ├── 20/ # WCAG 2.0 Understanding docs
│ │ ├── 21/ # WCAG 2.1 Understanding docs
│ │ └── 22/ # WCAG 2.2 Understanding docs
│ └── wcag.json # Enhanced WCAG data with Understanding content
├── scripts/
│ ├── fetch-wcag-data.js # Fetch WCAG JSON from W3C
│ └── parse-understanding-docs.js # Parse Understanding HTML files
├── src/
│ ├── index.js # MCP server with stdio transport
│ ├── tools.js # Tool definitions (20 tools)
│ └── data-helpers.js # Data access utilities
├── netlify/
│ └── functions/api.js # Netlify Function handler
└── package.json
归因
WCAG数据来自 W3C WCAG知识库 (W3C文档许可证).
本软件包括从《网络内容无障碍指南》（WCAG）2.2复制或衍生的材料https://www.w3.org/TR/WCAG22/.版权所有©2023 W3C®（麻省理工学院、ERCIM、庆应义塾大学、北航大学）。
许可证
麻省理工学院
