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 分