ディストリビューションの選択
axe MCP サーバーは、2つのディストリビューションで提供されます。どちらも同じ analyze、 remediate、および igt ツールに対応しています 同じ 設定 をサポートしていますが、サーバーがマシン上で動作する方法が異なるだけです。お使いの環境に合ったものを選択してください。どちらも優劣はありません。
Docker 対 npm
| Docker | npm | |
|---|---|---|
| 実行環境 | Docker コンテナ | ホスト上の Node.js プロセス、 npx |
| ブラウザ | イメージにバンドルされています | Playwright 経由で Chromium をインストールするか、既存の Chrome/Chromium バイナリを指定します |
| 前提条件 | Docker がインストールされ、実行中であること | アクティブな Node.js LTS リリース |
到達性 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@1.60.0 install chromiumPlaywright を axe MCP サーバーで提供されるバージョンに固定してください — 現在は 1.60.0です。そのままでは npx playwright install chromium Playwright の最新のリリースに解決され、サーバーがサポートしていない Chromium リビジョンをインストールする可能性があります。この固定はサーバーリリースごとに変更される可能性があり、Chromium 関連の起動エラーが 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