a11y-mcp

axe-core を使ってウェブページのアクセシビリティを監査するための MCP (Model Context Protocol) サーバーです。監査結果をお気に入りの AI アシスタント (Cline/Cursor/GH Copilot) と連携してエージェントループで使用すれば、A11y の問題を自動的に修正してくれます。

特徴

あらゆるウェブページで詳細なアクセシビリティ監査を実行します
アクセシビリティの問題の概要を取得する
特定のWCAG基準で監査をフィルタリングする
デバッグを容易にするために結果に HTML スニペットを含める

インストール

# Install globally
npm install -g a11y-mcp

# Or use directly with npx
npx a11y-mcp

構成

この MCP サーバーを Cline で使用するには、MCP 設定構成ファイルに追加する必要があります。

MCP構成

mcpServersオブジェクトに以下を追加します。

{
  "mcpServers": {
    "a11y": {
      "command": "npx",
      "args": ["a11y-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

利用可能なツール

監査ウェブページ

Web ページの詳細なアクセシビリティ監査を実行します。

パラメータ:

url (必須): 監査するウェブページのURL
includeHtml (オプション): 結果に HTML スニペットを含めるかどうか (デフォルト: false)
tags (オプション): チェックする特定のアクセシビリティタグの配列 (例: wcag2a、wcag2aa、wcag21a、best-practice)

例：

Use the a11y MCP server to audit example.com for accessibility issues

要約を取得する

Web ページのアクセシビリティの問題の概要を取得します。

パラメータ:

url (必須): 監査するウェブページのURL

例：

Give me an accessibility summary of example.com

使用例

設定が完了したら、Claude に MCP サーバーを使用してアクセシビリティ監査を実行するように依頼できます。

「example.com のアクセシビリティの問題を確認できますか?」
「 https://mywebsite.comのウェブサイトが WCAG 2.1 AA に準拠しているか監査してください」
「 https://example.comのアクセシビリティ問題の概要を教えてください」
「 http://localhost:3000にあるローカル開発サーバーに重大なアクセシビリティの問題があるかどうかを確認します」

発達

開発用にサーバーをローカルで実行するには:

npm start

リリース

このプロジェクトには、バージョン管理とnpmへの公開を支援するリリーススクリプトが含まれています。このスクリプトは、バージョンアップ、テストの実行、gitタグの付与、npmへの公開を処理します。

新しいバージョンをリリースするには:

# Make sure the script is executable
chmod +x release.sh

# Release a patch version (default)
./release.sh

# Release a minor version
./release.sh --minor

# Release a major version
./release.sh --major

# Release a specific version
./release.sh --version=1.2.3

# Skip git operations
./release.sh --skip-git

# Dry run (no changes will be made)
./release.sh --dry-run

# Force release even with uncommitted changes
./release.sh --force

詳細については、以下を実行してください。

./release.sh --help

ライセンス

MPL 2.0

クレジット

このプロジェクトはaxe-coreの素晴らしい成果の上に構築されています

This server cannot be installed

-

security - not tested

-

license - not tested

-

quality - not tested