a11y-mcp-server
a11y-mcp-server
用于无障碍审计、WCAG 标准查询和修复指南的 MCP 服务器。已过时。
功能
a11y_lookup_wcag: 按编号、关键词或级别查询 WCAG 2.2 标准
a11y_check_pattern: 分析 HTML 片段中常见的无障碍问题
a11y_suggest_fix: 获取包含修改前后代码示例的修复模式
a11y_document_component: 为 18 种以上的 UI 组件类型生成无障碍文档
a11y_audit_summary: 根据问题列表生成专业的审计报告
Related MCP server: @accesslint/mcp
本地开发
# Install dependencies
npm install
# Build
npm run build
# Run locally
npm start
# Server runs on http://localhost:8080
# Health check: http://localhost:8080/health
# MCP endpoint: http://localhost:8080/mcpNFSN 部署
我个人路径的先决条件;仅供参考:
拥有资金的 NFSN 账户(初始存款约 10 美元)
已配置 SSH 访问
设置步骤
1. 创建 NFSN 站点
登录 NFSN 会员界面
Sites → Create a New Site
站点类型:Custom(Node.js 守护进程必需)
记录您的站点主机名(例如
yoursite.nfshost.com)
2. 上传代码
# From project directory
rsync -avz --exclude node_modules --exclude .git --exclude dist \
./ USERNAME_SITENAME@ssh.phx.nearlyfreespeech.net:/home/protected/a11y-mcp-server3. SSH 设置
ssh USERNAME_SITENAME@ssh.phx.nearlyfreespeech.net
# Navigate to project
cd /home/protected/a11y-mcp-server
# Check Node.js version (should be 18+)
node --version
# Install dependencies
npm install --production
# Build
npm run build
# Make run.sh executable
chmod +x run.sh
# Test locally
./run.sh
# Ctrl+C to stop4. 配置 NFSN 守护进程
进入 NFSN 站点控制面板
Sites → Your Site → Site Information → Daemons
添加守护进程:
Tag:
nodeCommand Line:
/home/protected/a11y-mcp-server/run.shWorking Directory:
/home/protected/a11y-mcp-server
5. 配置 NFSN 代理
Sites → Your Site → Site Information → Proxies
添加代理:
Protocol:
httpBase URI:
/mcpDocument Root: (留空)
Target Port:
8080
6. 验证部署
# Check health endpoint
curl https://yoursite.nfshost.com/health
# Test MCP endpoint
curl -X POST https://yoursite.nfshost.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'故障排除
检查守护进程日志:
ssh USERNAME_SITENAME@ssh.phx.nearlyfreespeech.net
cat /home/protected/a11y-mcp-server/daemon.log重启守护进程: 通过 NFSN 控制面板:Sites → Daemons → Restart
检查守护进程是否正在运行:
ps aux | grep nodeClaude Code 配置
添加到 ~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"a11y": {
"url": "https://yoursite.nfshost.com/mcp"
}
}
}然后重启 Claude Code。
使用 Claude Code 进行本地测试
在 NFSN 部署前进行测试,请在本地运行服务器并配置 Claude Code 进行连接:
启动服务器:
npm start添加到
~/.config/claude/claude_desktop_config.json:
{
"mcpServers": {
"a11y-local": {
"url": "http://localhost:8080/mcp"
}
}
}重启 Claude Code
评估问题
使用这些问题来验证服务器是否正常工作:
WCAG 查询:“哪个 WCAG 标准涵盖键盘导航,其级别是什么?”
预期:返回 2.1.1 键盘(A 级)及详细信息
修复模式:“装饰性图像缺少 alt 文本的修复模式是什么?”
预期:返回包含空 alt="" 示例的模式
组件文档:“为模态对话框组件生成无障碍文档。”
预期:返回键盘交互、ARIA 属性、屏幕阅读器预期
WCAG 2.2 搜索:“哪些 WCAG 2.2 标准是针对移动/触摸交互的?”
预期:返回 2.5.x 输入模态标准
常见失败:“标准 1.4.3 对比度的常见失败有哪些?”
预期:返回 F24、F83 失败技术
使用示例
查询 WCAG 标准
Query: "What WCAG criterion covers keyboard navigation?"
Tool: a11y_lookup_wcag
Args: { "query": "keyboard" }检查 HTML 问题
Query: "Check this HTML for accessibility issues"
Tool: a11y_check_pattern
Args: { "html": "<img src='logo.png'><button><svg>...</svg></button>" }获取修复模式
Query: "How do I fix missing alt text on decorative images?"
Tool: a11y_suggest_fix
Args: { "issueType": "missing-alt-decorative" }生成组件文档
Query: "Generate accessibility documentation for a modal dialog"
Tool: a11y_document_component
Args: { "componentType": "modal" }更新 WCAG 数据
WCAG 标准打包在 src/data/wcag-criteria.json 中。更新步骤:
使用新标准编辑 JSON 文件
重新构建:
npm run build重新部署到 NFSN
许可证
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn accessibility expert MCP server that provides AI coding assistants with real-time access to WAI-ARIA patterns, code review, contrast checking, and WCAG guidance for writing accessible code from the start.4MIT

@accesslint/mcpofficial
AlicenseNot gradedqualityFmaintenanceAn MCP server for WCAG accessibility auditing in AI coding agents, providing tools to audit HTML, files, URLs, and diffs, plus a prompt for React component auditing.3066MIT- AlicenseNot gradedqualityAmaintenanceAn MCP server that lets an AI agent scan a web page for WCAG accessibility issues and get back findings it can act on.221MIT
- AlicenseAqualityDmaintenanceAn MCP server for web accessibility testing that enables scanning, auditing, and fixing WCAG, ADA, and other compliance issues directly from your IDE, with free local scans, AI-generated framework-aware fixes, and verification capabilities.14206MIT
Related MCP Connectors
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Website QA for your coding agent: audit SEO, performance, security, accessibility over MCP.
A paid remote MCP for CodeG, built to return verdicts, receipts, usage logs, and audit-ready JSON.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/shawnmcb/a11y-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server