Wahl einer Distribution
Der axe MCP Server wird in zwei Distributionen ausgeliefert. Beide bieten dieselben analyze, remediate, und igt Werkzeuge und nutzen dieselbe Konfiguration — sie unterscheiden sich nur darin, wie der Server auf Ihrem Rechner läuft. Wählen Sie diejenige, die am besten zu Ihrer Umgebung passt; keine ist vorzuziehen.
Docker vs. npm
| Docker | npm | |
|---|---|---|
| Laufzeit | Ein Docker-Container | Ein Node.js-Prozess auf Ihrem Host, der bei Bedarf mit npx |
| Browser | In das Image integriert | Chromium über Playwright installieren oder auf eine bestehende Chrome/Chromium-Binärdatei verweisen, die Sie bereits haben |
| Voraussetzung | Docker installiert und läuft | Ein aktives Node.js LTS-Release |
Erreichbarkeit localhost |
Benötigt --add-host; siehe ERR_CONNECTION_REFUSED |
Erreicht Host- localhost Dienste direkt |
| Am besten, wenn | Sie bereits Docker verwenden und eine in sich geschlossene Umgebung möchten | Sie Docker nicht ausführen können oder einen leichteren lokalen Prozess bevorzugen |
Docker
Ziehen Sie das Image zuerst und jedes Mal, wenn Sie auf eine neuere Version umsteigen möchten:
docker pull dequesystems/axe-mcp-server:latestDas ist der einzige Installationsschritt — Ihr MCP-Client startet den Container bei Bedarf mit der Konfiguration in Ihrem Kunden-Einrichtungsanleitung.
npm
Es gibt keinen separaten Installationsschritt für den Server selbst — npx -y axe-mcp-server lädt ihn herunter und führt ihn bei Bedarf aus, und Ihr MCP-Client ruft diesen Befehl für Sie auf (siehe Ihre Kunden-Einrichtungsanleitung).
Die npm-Verteilung läuft auf Node.js. Verwenden Sie eine aktive LTS-Version von Node.js – ältere Versionen werden möglicherweise nicht unterstützt.
Chromium installieren
Weil der Server einen echten Browser zum Ausführen von Scans verwendet, müssen Sie ein passendes Chromium-Build selbst über Playwrightinstallieren:
npx playwright@1.60.0 install chromiumPin Playwright auf die Version, die der axe MCP Server verwendet — derzeit 1.60.0. Ein einfaches npx playwright install chromium löst sich auf die neueste Playwright-Veröffentlichung, die eine Chromium-Revision installieren kann, die der Server nicht unterstützt. Diese Fixierung kann sich zwischen Server-Releases ändern; der mit Chromium verbundene Startfehler verweist Sie auf Chromium-Installationsprobleme beheben , wenn die Versionen abweichen.
Unter Linux benötigen Sie möglicherweise auch die Systembibliotheken, von denen Chromium abhängt. Siehe Fehlerbehebung bei der Chromium-Installation für Details.
Alternative: Verwenden Sie einen vorhandenen Browser
Wenn Sie bereits eine kompatible Chrome/Chromium-Binärdatei auf Ihrem Rechner haben, können Sie die Playwright-Installation überspringen und stattdessen den Server darauf verweisen, indem Sie die AXE_CHROME_PATH Umgebungsvariable setzen. Dies ist nur bei der npm-Distribution verfügbar — das Docker-Image verwendet immer seinen mitgelieferten Browser. Siehe AXE_CHROME_PATH für Anforderungen und Einschränkungen.
Nächste Schritte
- Authentifizierung einrichten — ein API-Schlüssel oder OAuth 2.0
- Konfigurieren Sie Ihren Client — VS Code mit Copilot, Cursor, oder Claude Code
