wcagc-mcp 是一个面向 AI 助手的 MCP 服务器，让 Claude、ChatGPT 或任何兼容 MCP 的客户端通过用户自己的 wcagc 账号执行真实、确定性的无障碍扫描，底层使用 axe-core，而非依赖 LLM 推测。扫描覆盖 WCAG、EN 301 549 与 PDF/UA。
主要能力 它可以扫描 URL 和 PDF、抓取站点、回放用户旅程并读取违规趋势。每个扫描结果都附带明确的覆盖范围免责声明，且从不声称“合规”：自动化测试只能发现部分无障碍障碍，该工具会在每次响应中说明这一点。
实现方式 该包是一个轻量、无状态的适配器：不包含数据库、扫描逻辑，除 wcagc API 基础 URL 外不保存任何密钥。它把 MCP 工具调用转换为针对 wcagc API 的 HTTP 调用，并转发调用方自己的 bearer 令牌。所有认证、授权、配额和扫描编排都在 API 端完成，因此这份代码可以安全地端到端审阅。
两种运行方式
- 本地（stdio）——适用于 Claude Desktop、Cursor 或任何能启动本地进程的 MCP 客户端。
- 托管（Streamable HTTP + 托管 OAuth）——适用于 Claude 网页/桌面/移动连接器和 ChatGPT，因为两者都不会替用户运行本地进程。
使用方式 本地方式下，需要在 MCP 客户端中进行配置，并在 wcagc 账号的 Settings → API keys 下生成 mcp:scan 密钥；该密钥在所有套餐中均可用，Free/Starter 有每日配额，Pro/Agency 无限制。托管方式下，添加远程 MCP 连接器后，客户端会先发现 /.well-known/oauth-protected-resource/mcp，打开 wcagc 登录/授权流程，并将连接绑定到一个组织，无需复制粘贴密钥。本地 stdio 与 CI 仍支持 API 密钥 bearer 认证。
工具与数据读取 scan_url 使用一个 id 和一个轮询工具：无论 scan_url 对 URL 做了什么，get_scan 和 get_findings 都能读取回来。get_run 和 get_run_findings 仅用于从 scan_site 发起的全站运行。每个产生扫描的工具都会在文本内容和结构化内容中返回覆盖范围免责声明。系统不提供评分、等级或合规结论——自动化测试大约只能发现 30–57% 的无障碍问题，其余需要人工审查。
限制与可用性 ChatGPT 的可用性取决于 ChatGPT 套餐以及客户端是否允许操作类工具；scan_url 会创建扫描，并非只读操作。托管 HTTP 请求到 /mcp 及发现端点会生成带请求 ID、HTTP 状态、MCP 方法、错误码和耗时的 JSON 日志，令牌、请求头、查询字符串、工具参数和结果会被排除，健康探测不记录。Docker 入口点预加载 New Relic ESM 代理，设置 NEW_RELIC_AGENT_ENABLED=true、NEW_RELIC_APP_NAME=wcagc-mcp 以及部署密钥 NEW_RELIC_LICENSE_KEY 可启用 APM 并转发这些安全的请求日志；许可证密钥必须属于现有 New Relic 账号，切勿提交到代码库。stdio 入口点不加载该代理。项目以 MIT 许可发布。
