Overlayrisk Witness

io.github.mertcanvural由 GitHub 账号 mertcanvural 发布v0.1.0更新于 Oct 24, 2026

Independent before/after accessibility-overlay (accessiBe/UserWay) witness for any public URL.

已验证STDIO仅桌面网页搜索与抓取开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，对任意公开网址运行免费的独立无障碍覆盖组件前后对比见证，并返回一条有据可查的发现。

可以做什么
对公开页面网址运行见证：分别以覆盖组件开启和关闭两种状态加载页面，由托管 API 完成检测与声明提取并捕获两种状态。获取免费见证结果：运行 ID、站点网址、覆盖组件厂商、测试的页面与声明数、未成立的声明、一条免费发现以及锁定发现的数量。获取结构化错误码，例如 overlay_no_effect、page_fetch_failed 或 witness_timeout。该服务器只是轻量客户端，自身不含扫描逻辑。
适用场景
当你希望助手核实无障碍覆盖组件（accessiBe、UserWay 或类似产品）是否真的改变了公开页面以供辅助技术用户使用，并希望得到带时间戳的证据性发现而非合规裁定时会用到。
运行要求
以 stdio 在本地运行，通常通过 npx 使用 npm 包 overlayrisk-witness-mcp。需要能访问托管见证端点的网络。无需 API 密钥。可选环境变量 OVERLAYRISK_API_URL（覆盖端点）和 OVERLAYRISK_TIMEOUT_MS（默认 200000）。单次运行最长约 3 分钟，不支持按进度重置超时的客户端应调高请求超时。
安装前请注意
唯一的工具会把提交的公开网址发送给第三方托管服务进行扫描。发现属于证据，不是法律合规裁定。完整的带时间戳风险包需在网站上付费购买；服务器本身不处理付款。该服务器声明独立于 accessiBe 和 UserWay。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Overlayrisk Witness，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

OverlayRiskWitness MCP server

A Model Context Protocol server that runs the free, independent before/after accessibility-overlay witness from OverlayRiskWitness on any public URL.

Accessibility overlay widgets (accessiBe, UserWay, and similar) are sold as one-line ADA/WCAG compliance fixes, but independent testing routinely shows the underlying page is unchanged for real assistive-technology users. This server lets an AI agent run the witness: it loads a page with the overlay on, then off, captures both states, and returns one documented finding where the page's public accessibility/compliance claims don't hold up — with a UTC timestamp.

Findings are evidence, not a legal compliance ruling. This server is independent of accessiBe and UserWay; it tests their effect, it does not sell or defend an overlay.

What this server is (and isn't)

This is a thin client. It contains no scanning logic and no secrets. Its single tool POSTs to the hosted API at https://overlayrisk.com/api/witness, which does the real work (overlay detection, headless before/after capture, claim extraction). The full timestamped Risk Packet is a paid checkout on the website — see overlayrisk.com/pricing. The MCP server is a free funnel; it never handles payment.

Tool

witness_page

Input{ "url": "https://example.com/checkout" } — a public HTTP/HTTPS page URL
SuccessThe free-witness JSON: runId, siteUrl, overlayVendor (accessibe/userway), pagesTested, claimsTested, didNotHoldUp, freeFinding, lockedFindingCount — plus a note linking to the paid Risk Packet
Error{ status, code, error } (e.g. overlay_no_effect, page_fetch_failed, witness_timeout)

A single witness run can take up to ~3 minutes on cold/heavy sites. That exceeds many MCP clients' default 60s request timeout. The server emits periodic progress notifications, so clients that honor resetTimeoutOnProgress stay connected automatically; clients that don't should raise their per-request timeout.

Install

Run directly with npx (no global install):

bash
npx overlayrisk-witness-mcp

The process speaks MCP over stdio.

Claude Desktop / Cursor / other MCP clients

Add to your client's MCP config:

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

Configuration

Env varDefaultPurpose
OVERLAYRISK_API_URLhttps://overlayrisk.com/api/witnessOverride the witness endpoint (e.g. for local dev)
OVERLAYRISK_TIMEOUT_MS200000Request timeout in ms

No API key is required — the free one-page witness is public.

Develop

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

License

MIT © Mert Can Vural

来源：README.md，提交 3dd25b7

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分