ディストリビューションの選択
axe MCPサーバーは2つの配布版で提供されます。どちらも同じanalyze、remediate、およびigtのツールを公開し、同じ設定を尊重しますが、サーバーがあなたのマシン上で動作する方法が異なるだけです。環境に合った方を選んでください。どちらも優先されません。
Docker 対 npm
| Docker | npm | |
|---|---|---|
| 実行環境 | Docker コンテナ | ホスト上でオンデマンドでnpxと共に起動するNode.jsプロセス |
| ブラウザ | イメージにバンドルされています | 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
