a11y-toolkit MCP

WCAG 2.2アクセシビリティスイートを、AIエージェント向けMCPサーバー（Model Context Protocol）として提供します。さらに統合CLIも付属します。中核は依存関係ゼロで、すべての計算はローカルかつ正確です（公式の相対輝度の式を使用）。

監査 → 修正 → 文書化 → 回帰監視の全サイクルを、1つのツールキットにまとめました：

1. 監査: 任意のURLに対する簡易WCAG監査（重大度順の結果）

2. 修正: 正確なコントラストチェック — カラーペア および 画像上のテキスト（実際の背景をピクセル単位でサンプリング）— 合格に最も近い色の提案付き

3. 文書化: EUの法的アクセシビリティ宣言を、アクセシブルなHTMLとして生成

4. 監視: ビルド間のスナップショットと差分（diff）で、本番リリース前にアクセシビリティの回帰を検出

全ツールで多言語es/enに対応（ENの宣言書は指令(EU) 2016/2102と指令(EU) 2019/882 — 欧州アクセシビリティ法 — の文言を使用しており、EU全域で有用です）。

MCPツール（9）

Related MCP server: Accessibility MCP Server

MCPとしてインストール

{
  "mcpServers": {
    "a11y-toolkit": {
      "command": "python3",
      "args": ["/path/to/a11y-toolkit/server.py"]
    }
  }
}

または、クローン不要のuvを使用：

{
  "mcpServers": {
    "a11y-toolkit": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kinti/a11y-toolkit", "a11y-toolkit-mcp"]
    }
  }
}

a11y_snapshot を使用する予定がある場合は、"timeoutMs": 60000 を追加してください（ブラウザ起動）。

統合CLI — すべてを1コマンドで

a11y pair "#1f2328" "#fbfaf7"                     # contrast, per-criterion verdicts
a11y image hero.jpg --text "#ffffff" --region 120,40,420,90
a11y audit --url https://example.com              # express WCAG audit
a11y declaration --entidad "Acme" --url https://acme.example \
       --estado parcial --marco eaa --lang en --output decl.html
a11y snapshot https://mysite --out before.json    # before deploy (needs Playwright)
a11y diff before.json after.json                  # after deploy

リポジトリから実行：python3 a11y.py <subcommand>

画像モードの解釈

• ratio_peor（最悪値）— テキスト色にとって最も敵対的な箇所。

• area_pasa_aa_texto_normal_4_5 — 安全な表面の%。テキストが配置されている場所で100%未満の場合：スクリム／オーバーレイ、トリミング、またはテキストの移動。

• zona_peor — 最も不合格の度合いが大きい3×3グリッドのセル（正確な座標付き）。

セキュリティと適用範囲

ローカルツール：お使いのマシン上で、あなたのユーザーとして実行されます。path（画像）とoutput_path（宣言書）の引数はローカルパスを読み書きします — 信頼するMCPクライアントで使用してください。ネットワークに送信されるものはありません（明示的に監査するURLの取得を除く）。

技術メモ

• 画像デコード：Pillowが利用可能な場合はPillow、それ以外はsips（macOS）。PPMは常に使用可能（CIに依存関係が不要なのはそのためです）。

• aria-liveモニターには、文書化された設計上の教訓があります：そのパネルは意図的にライブリージョンではなく、オブザーバーからそれ自体を除外しています — role="log" のパネルは自分自身のセレクターに一致し、無限の自己観察ループを生み出すからです。実際に私たちに起こったことなので、これは確かです。

• 実際の本番サイト（作者自身のサイトで、当然ながら自身の監査に合格しなければならないもの）でテスト済み。

• 人間向けのWeb版（同じ計算ロジック）：jquin.net/lab — コントラスト（ペア＋画像）、宣言書ジェネレーター、aria-liveモニター、ビルド差分。

スペイン語

MCPサーバー＋統合CLIとして提供するWCAG 2.2アクセシビリティスイート。中核は依存関係ゼロ（Pillowはオプション、macOSではsips、PPMは常に使用可能）。すべてのサイクルを1つのツールキットに集約：監査（a11y_audit_url）→ 修正（ピクセル単位のサンプリングと敵対ゾーン検出によるペアのコントラストおよび画像上のテキスト；アクセシブルな色の提案）→ 文書化（RD 1112/2018 第10条またはLey 11/2023/EAAに基づく法的宣言書をアクセシブルなHTMLで生成）→ 監視（ビルド間のスナップショットと差分：追加・削除・名称変更とフォーカス順）。

MCPツールは9つ（上の表を参照）・多言語es/en（ENの宣言書は指令(EU) 2016/2102と2019/882の用語を使用）・サブコマンドpair、image、audit、declaration、snapshot、diffを持つ統合CLI a11y。

{ "mcpServers": { "a11y-toolkit": {
    "command": "python3", "args": ["/ruta/al/repo/server.py"] } } }

ローカルツール：path と output_path の引数はローカルパスを読み書きします。明示的に監査するURL以外は、ネットワークに送信されるものはありません。aria-liveモニターはその設計上の教訓を物語っています：パネルはライブリージョンではなく、オブザーバーからそれ自体を除外します（role="log" は自分自身のセレクターに一致し、無限の自己観察ループを生み出します — 実際に起こったことなので、私たちは知っています）。人間向けのWeb版：jquin.net/lab。

著者 / Author

Jesús Quintana Fernández（jquin.net）— 2003年からのSEO／GEOコンサルタントであり、ウェブアクセシビリティの実践者。MIT © 2026。