mcpField
O
overlayrisk-witness

overlayrisk-witness

本地服务
overlayrisk.com开发工具018 周前更新
代码仓库访问官网

关于 overlayrisk-witness

overlayrisk-witness 是一个轻量 MCP 客户端，可对公开 URL 运行 OverlayRisk 的独立无障碍覆盖层检查。它比较页面启用和关闭覆盖层时的状态，并返回带时间戳的记录；结果是证据，不是法律合规裁定。

主要功能

  1. 01页面前后状态捕获
  2. 02覆盖层检测
  3. 03无障碍声明测试
  4. 04带时间戳的发现
  5. 05进度通知

适用场景

  1. 01检查使用 accessiBe 的公开网站
  2. 02核查 UserWay 覆盖层的效果
  3. 03记录无障碍声明与实际差异

MCP 相关

该 MCP 服务提供 `witness_page` 工具，将公开 URL 发送到 OverlayRisk 托管 API，并返回免费见证结果。完整的带时间戳 Risk Packet 需通过网站付费结账获取。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "mertcanvural-overlayrisk-witness": {
      "command": "npx",
      "args": [
        "-y",
        "overlayrisk-witness-mcp"
      ],
      "env": {
        "OVERLAYRISK_API_URL": "<OVERLAYRISK_API_URL>"
      }
    }
  }
}
启动命令npx -y overlayrisk-witness-mcp
需要配置的环境变量
OVERLAYRISK_API_URLOverride the hosted witness endpoint (defaults to https://overlayrisk.com/api/witness).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmoverlayrisk-witness-mcp0.1.0

工具

1

收录的工具列表 · 更新于 3 周前

参数类型必填说明
urlstring是要通过免费 OverlayRiskWitness 见证检查的 HTTP 或 HTTPS 公共网页 URL。

详细介绍

OverlayRiskWitness MCP 服务

一个 Model Context Protocol 服务，可在任意公开 URL 上运行来自 OverlayRiskWitness 的免费、独立的无障碍覆盖层前后对照验证。

无障碍覆盖层组件（accessiBe、UserWay 等）被包装成只需一行代码即可解决 ADA/WCAG 合规问题的方案，但独立测试常常表明，对于实际使用辅助技术的用户而言，底层页面并未改变。此服务可让 AI Agent 运行验证：它先加载覆盖层开启的页面，再加载覆盖层关闭的页面，捕获这两种状态，并返回一项有记录的发现，指出页面公开声明的无障碍性／合规性问题 — 以及 UTC 时间戳。

发现是证据，而非法律合规裁定。此服务独立于 accessiBe 和 UserWay；它测试这些产品的效果，不销售或辩护任何覆盖层。

此服务的功能与非功能

这是一个轻量客户端。它不包含扫描逻辑，也不包含机密信息。其唯一工具会向托管 API https://overlayrisk.com/api/witness 发送 POST 请求，由该 API 执行实际工作（检测覆盖层、无头浏览器前后对照捕获、提取声明）。完整的带时间戳风险数据包需在网站上付费购买 — 请参阅 overlayrisk.com/pricing。MCP 服务是免费的引流入口；它不会处理付款。

工具

witness_page
输入{ "url": "https://example.com/checkout" } — 公开的 HTTP/HTTPS 页面 URL
成功免费验证 JSON：runId、siteUrl、overlayVendor（accessibe/userway）、pagesTested、claimsTested、didNotHoldUp、freeFinding、lockedFindingCount — 另附一条链接至付费风险数据包的说明
错误{ status, code, error }（例如：overlay_no_effect、page_fetch_failed、witness_timeout）

在冷启动／负载较高的网站上，单次验证最多可能需要约 3 分钟。这超过了许多 MCP 客户端默认的 60 秒请求超时时间。此服务会定期发送进度通知，因此支持 resetTimeoutOnProgress 的客户端会自动保持连接；不支持的客户端应提高每个请求的超时时间。

安装

使用 npx 直接运行（无需全局安装）：

npx overlayrisk-witness-mcp

该进程通过 stdio 使用 MCP 协议通信。

Claude Desktop / Cursor / 其他 MCP 客户端

将以下内容添加到客户端的 MCP 配置中：

{
  "mcpServers": {
    "overlayrisk-witness": {
      "command": "npx",
      "args": ["-y", "overlayrisk-witness-mcp"]
    }
  }
}

配置

环境变量默认值用途
OVERLAYRISK_API_URLhttps://overlayrisk.com/api/witness覆盖验证端点（例如用于本地开发）
OVERLAYRISK_TIMEOUT_MS200000请求超时时间，单位为毫秒

无需 API 密钥 — 免费的单页验证服务是公开的。

开发

npm install
npm run smoke   # offline handshake test (lists tools, no network)
npm start       # run the server on stdio

许可证

MIT © Mert Can Vural

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。