ディストリビューションの選択
axe MCPサーバーは2つの配布版で提供されます。どちらも同じanalyze、remediate、およびigtのツールを公開し、同じ設定を尊重しますが、サーバーがあなたのマシン上で動作する方法が異なるだけです。環境に合った方を選んでください。どちらも優先されません。
両方のディストリビューションは、npmjs.orgとDocker Hubの公開レジストリにアクセスできることを前提としています。もしネットワークがこれらへのアクセスを制限している場合は、DequeのAgoraからのインストールを参照してください。
Docker 対 npm
| Docker | npm | |
|---|---|---|
| 実行環境 | Docker コンテナ | ホスト上でオンデマンドでnpxと共に起動するNode.jsプロセス |
| ブラウザ | イメージにバンドルされています | Playwright 経由で Chromium をインストールするか、既存の Chrome/Chromium バイナリを指定します |
| 前提条件 | Docker がインストールされ、実行中であること | Node.js 22.19.0以降 |
localhostに到達中 |
--add-hostが必要; ERR_CONNECTION_REFUSEDを参照 |
ホストlocalhostサービスに直接到達 |
| 最適な条件 | Docker を既に使用しており、独立した環境が必要な場合 | Docker を実行できない、またはより軽量なローカルプロセスを好む場合 |
Docker
最初にイメージを取得し、新しいリリースに移行したいときに取得します:
docker pull dequesystems/axe-mcp-server:latestこれが唯一のインストールステップです — MCPクライアントがオンデマンドでコンテナを起動し、クライアント設定ガイドの設定を使用します。
npm
サーバー自体には別のインストールステップはありません — npx -y axe-mcp-serverがそれをオンデマンドでダウンロードし実行し、MCPクライアントがそのコマンドを呼び出します（クライアント設定ガイドを参照）。
npmディストリビューションはNode.jsで動作します。アクティブなNode.js LTSリリースを使用してください — 古いリリースはサポートされていない可能性があります。
Chromium のインストール
サーバーはスキャンを実行するために実際のブラウザを使用するので、Playwrightを介して対応するChromiumビルドを自分でインストールする必要があります：
npx playwright@$(npm view axe-mcp-server dependencies.playwright) install chromiumこれは公開されたパッケージからピンを取得するため、サーバーの更新に伴って正しいままです。Playwrightはピン留めされる必要があります。裸のnpx playwright install chromiumはPlaywrightの最新リリースに解決され、サーバーがサポートしていないChromiumリビジョンをインストールする可能性があります。
古いaxe-mcp-serverにピン留めされていますか、それともオフラインですか？ The command above reads the dependency of the 最新 published release. If you run a pinned older version, substitute its Playwright version instead — npm view axe-mcp-server@<version> dependencies.playwright — or take it from the Chromium startup error, which names the exact command for the server you are actually running. At the time of writing, server version 1.4.0 ships Playwright 1.61.1.
Windowsでのcmd.exeでは、$(...)の置換がないため、npm view axe-mcp-server dependencies.playwrightを単独で実行し、バージョンをコマンドに貼り付けてください。PowerShell、Git Bash、およびWSLはそのままコマンドを処理します。
バージョンがずれる場合はChromiumインストールのトラブルシューティングを参照してください。
Linuxでは、Chromiumが依存するシステムライブラリも必要になるかもしれません。詳細はChromiumインストールのトラブルシューティングを参照してください。
代替方法: 既存のブラウザを使用
すでに互換性のあるChrome/Chromiumバイナリがマシンにある場合、Playwrightのインストールをスキップし、代わりにAXE_CHROME_PATH環境変数を設定してサーバーをそこに向けることができます。これはnpm配布版でのみ利用可能です — Dockerイメージは常にバンドルされたブラウザを使用します。要件や注意点についてはAXE_CHROME_PATHを参照してください。
次のステップ
- 認証の設定 — APIキーまたはOAuth 2.0
- クライアントを構成する — VS CodeとCopilot、Cursor、またはClaude Code