overlayrisk-witness

OverlayRiskWitness MCP サーバー

あらゆる公開 URL で、OverlayRiskWitness の 無料かつ独立した、アクセシビリティオーバーレイの適用前後を検証する機能を実行する Model Context Protocol サーバーです。

アクセシビリティオーバーレイウィジェット（accessiBe、UserWay など）は、ADA/WCAG 準拠を一行で実現する修正として販売されています。しかし、独立したテストでは、支援技術を利用するユーザーにとって、ページの基盤部分は変わっていないことが繰り返し示されています。このサーバーを使うと、AI エージェントが検証を実行できます。オーバーレイをオンにした状態でページを読み込み、続いてオフにして両方の状態をキャプチャし、公開されているページのアクセシビリティ／コンプライアンスに関する主張が実際には成立しないことを示す、UTC タイムスタンプ付きの記録された所見を返します。

所見は証拠であり、法的なコンプライアンス判断ではありません。 このサーバーは accessiBe および UserWay から独立しています。オーバーレイの効果をテストするものであり、 オーバーレイを販売または擁護するものではありません。

このサーバーの機能と、機能しないこと

これは薄いクライアントです。スキャンロジックは含まず、シークレットも保持しません。唯一の ツールはホストされた API https://overlayrisk.com/api/witness に POST します。実際の 処理（オーバーレイの検出、ヘッドレスでの適用前後のキャプチャ、主張の抽出）は、この API が実行します。タイムスタンプ付きの完全な Risk Packet は、ウェブサイトで有料購入できます。詳しくは 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 — 有料の Risk Packet へのリンクを含む注記も付属します
エラー	{ status, code, error }（例：overlay_no_effect、page_fetch_failed、witness_timeout）

1 回の検証には、読み込み直後や負荷の高いサイトでは最大約 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_URL	https://overlayrisk.com/api/witness	検証エンドポイントを上書きします（例：ローカル開発用）
OVERLAYRISK_TIMEOUT_MS	200000	リクエストのタイムアウト（ミリ秒）

API キーは不要です。1 ページの無料検証は公開されています。

開発

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

ライセンス

MIT © Mert Can Vural