WCAG 2.2 Compliance

wcag-compliance-mcp

WCAG 2.2 の監査、検証済みの修正例、米国のアクセシビリティ対応期限を扱う MCP サーバーです。ツールは 4 つで、API キーもネットワーク呼び出しも不要です。すべてのデータが同梱されています。

ヘッドレス Chromium で検証済みのベンチマークに基づいて構築されています。axe-core 4.14.0 に対して実行した 64 組の失敗／合格 HTML ペア、WCAG 2.2 の 87 の達成基準、1990 年の ADA から 2028 年の DOJ Title II 期限までの、出典付き規制日程 21 件を含みます。

公式 MCP レジストリでは io.github.Veduis/wcag-compliance-mcp として登録されており、97k star の MCP ディレクトリおよびアクセシビリティツール一覧にも掲載されています。

ツール

ツール	回答する内容
audit_html_snippet	この HTML にある WCAG 2.2 の不備、その不適合基準、修正例
lookup_wcag_criterion	1.4.3 の意味、その適合レベル、ADA Title II の対象となる組織への適用有無、自動化ルールの有無
get_verified_fix_example	不適合のスニペット、修正済みスニペット、重要な理由、手動でのテスト方法
check_ada_compliance_deadlines	組織の対応期限と、期限を定める規則

audit_html_snippet

フラグメントまたは完全なドキュメントを対象にした 18 項目の静的チェックです。

チェック項目	達成基準
テキストによる代替がない画像	1.1.1
alt のない画像ボタン	1.1.1
名前のない role="img" SVG	1.1.1
アクセシブルな名前のないリンク	2.4.4
アクセシブルな名前のないボタン	4.1.2
プログラムで関連付けられたラベルがないフォームフィールド	3.3.2
html lang がない	3.1.1
ページタイトルがない	2.4.2
見出しレベルの飛び越し、または h1 がない	1.3.1
重複した id 値	4.1.1
正の値の tabindex	2.4.3
フォーカス可能な要素に aria-hidden がある	4.1.2
ul／ol の子要素が li ではない	1.3.1
title がない iframe	4.1.2
th がないデータテーブル	1.3.1
字幕トラックのない video	1.2.2
ズームを制限する viewport メタタグ	1.4.4
autocomplete がない、用途が一般的な入力欄	1.3.5

検出結果にはすべて、該当する基準、問題のあるマークアップ、修正済みのスニペットが含まれます。

check_ada_compliance_deadlines

組織の種類：title_ii_large、title_ii_small、title_iii_business、federal_contractor、hhs_recipient、eu_business、ontario。

任意の日付について回答を計算するには as_of を渡します。これにより、過去に遡った適用範囲の確認や、特定の日に適用されていた規則を記載する必要がある法的メモの作成にも役立ちます。日付にはそれぞれ一次資料の URL が付いています。

インストール

npx -y github:Veduis/wcag-compliance-mcp

ほかに 3 つの方法があります。

方法	コマンド
MCPB バンドル（Claude Desktop、ワンクリック）	wcag-compliance-mcp.mcpb
公式レジストリ	io.github.Veduis/wcag-compliance-mcp
Docker	docker build -t wcag-compliance-mcp . && docker run -i --rm wcag-compliance-mcp

npm パッケージ wcag-compliance-mcp は次回の公開時に提供されます。それまでは GitHub の仕様を使って、同じコードと依存関係をインストールできます。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "wcag-compliance": {
      "command": "npx",
      "args": ["-y", "github:Veduis/wcag-compliance-mcp"]
    }
  }
}

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "wcag-compliance": {
      "command": "npx",
      "args": ["-y", "github:Veduis/wcag-compliance-mcp"]
    }
  }
}

VS Code（Copilot エージェントモード）

.vscode/mcp.json：

{
  "servers": {
    "wcag-compliance": {
      "command": "npx",
      "args": ["-y", "github:Veduis/wcag-compliance-mcp"]
    }
  }
}

Docker

docker build -t wcag-compliance-mcp .
docker run -i --rm wcag-compliance-mcp

使用例

エージェントに次のように依頼します。

この料金ページを WCAG 2.2 の問題がないか監査し、修正済みのマークアップを提示してください。

エージェントは audit_html_snippet を呼び出し、不適合の基準ごとに get_verified_fix_example を呼び出します。返されるのは、不明瞭な警告ではなく、不適合のスニペット、修正済みのスニペット、手動でのテスト手順です。

$ audit_html_snippet('<img src="chart.png">')

{
  "summary": {
    "issues": 1,
    "checks_run": 18,
    "checks_failed": 1,
    "conformance_claim": false
  },
  "findings": [
    {
      "check_id": "img-alt",
      "sc": "1.1.1",
      "level": "A",
      "title": "Image missing a text alternative",
      "count": 1,
      "elements": [
        {
          "snippet": "<img src=\"chart.png\">",
          "reason": "No alt, aria-label, or aria-labelledby. Decorative images need alt=\"\"."
        }
      ],
      "fix": "<img src=\"chart.png\" alt=\"Bar chart: Q3 revenue rose 18 percent over Q2\">"
    }
  ]
}

自動化では確認できないこと

これは機能一覧よりも重要です。このサーバーの基礎となったベンチマークでは、axe-core 4.14.0 が、意図的に欠陥を仕込んだ64件のドキュメントのうち39件を検出しました。残りの25件の検出には、スクリプトによるチェックまたは人による確認が必要でした。標準全体では、87項目の基準のうち、ルールが対応付けられているのは29項目で、58項目には対応するルールがありません。また、法律で実際に対象となるレベルAAでは、24項目の基準のうち、ルールがあるのはわずか7項目です。

そのため、このサーバーはすべての監査で conformance_claim: false を報告します。問題なしという結果は、静的な欠陥が見つからなかったことを意味するだけで、ページが準拠していることを示すものではありません。コントラスト、フォーカスの視認性、キーボードトラップ、読み上げ順序、字幕の正確性、エラーからの復旧には、レンダリングされたページまたは人による確認が必要です。これらのチェックを含むドメイン全体の監査が必要な場合は、vComplianceScanner をご利用ください。

データの来歴

データセット	DOI
プレプリント：自動テストで実際に検出されるもの	10.5281/zenodo.23829968
axe-core 4.14.0 でブラウザー検証済みの64組の不合格／合格例	10.5281/zenodo.23781867
ルールとの対応付けを含む、WCAG 2.2の87項目の達成基準	10.5281/zenodo.23781861
出典付きのADA／Section 504／EAAの日付21件	10.5281/zenodo.23781873
複数ターンにわたるLLMの修正プロンプト64件	10.5281/zenodo.23781879

ミラー：Hugging Face。テストケースはCC BY 4.0、コードはMITライセンスです。

開発

npm install
npm test          # 18 checks, including a live stdio handshake
npm start

構成：

src/index.mjs    MCP server, tool registration, resource
src/checks.mjs   18 static checks, no browser required
src/data.mjs     criteria, pairs, timeline, deadline resolution
data/            bundled JSON, generated from the published datasets
test/smoke.mjs   engine tests plus protocol handshake

Veduisのその他の情報

• WCAG 2.2開発者向け実装マニュアル
• ADA Title IIとTitle III：ウェブサイトに適用される法律
• ADAの要求通知への対応

ライセンス

コードはMITライセンスです。データセットの内容はCC BY 4.0で、Veduis LLCの表示が必要です。