Wahl einer Distribution

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Der axe-MCP-Server wird in zwei Distributionen ausgeliefert. Beide verfügen über die gleichen analyze, remediate und igt Werkzeuge und respektieren die gleichen 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 wird bevorzugt.

Docker vs. npm

Docker npm
Laufzeit Ein Docker-Container Ein Node.js-Prozess auf Ihrem Host, nach Bedarf gestartet 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
Erreichen von localhost Erfordert --add-host; siehe ERR_CONNECTION_REFUSED Direkter Zugriff auf Host-localhost-Dienste
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:latest

Das 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 bei Bedarf herunter und führt ihn aus, und Ihr MCP-Client ruft diesen Befehl für Sie auf (siehe Ihren Kunden-Einrichtungsanleitung).

Die npm-Distribution läuft auf Node.js. Verwenden Sie ein aktive LTS-Version von Node.js – ältere Versionen werden möglicherweise nicht unterstützt.

Chromium installieren

Da der Server einen echten Browser verwendet, um Scans durchzuführen, müssen Sie selbst ein passendes Chromium-Build über Playwright installieren:

npx playwright@1.60.0 install chromium
note

Fixieren Sie Playwright auf die Version, mit der der axe-MCP-Server ausgeliefert wird — derzeit 1.60.0. Ein einfaches npx playwright install chromium verweist auf die neueste Veröffentlichung von Playwright, die eine Chromium-Revision installieren kann, die vom Server nicht unterstützt wird. Diese Fixierung kann sich mit Serverversionen ändern; der mit Chromium verbundene Startfehler verweist Sie auf Fehlerbehebung bei der Chromium-Installation, falls die Versionen abweichen.

Unter Linux benötigen Sie möglicherweise auch die Systembibliotheken, von denen Chromium abhängt. Einzelheiten finden Sie unter Fehlerbehebung bei der Chromium-Installation.

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 den Server stattdessen über die AXE_CHROME_PATH-Umgebungsvariable darauf verweisen. Dies ist nur mit der npm-Distribution möglich — das Docker-Image verwendet immer seinen gebündelten Browser. Anforderungen und Einschränkungen finden Sie unter AXE_CHROME_PATH.

Nächste Schritte

  1. Authentifizierung einrichten — ein API-Schlüssel oder OAuth 2.0
  2. Konfigurieren Sie Ihren Client — VS Code mit Copilot, Cursor oder Claude Code

Is this page helpful?

Help us improve this page

Still need help?