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.

note

Beide Distributionen setzen voraus, dass Sie die öffentlichen Registries npmjs.org und Docker Hub erreichen können. Wenn Ihr Netzwerk den Zugriff darauf einschränkt, sehen Sie stattdessen Installation von Deques Agora.

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 Node.js 22.19.0 oder höher
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@$(npm view axe-mcp-server dependencies.playwright) install chromium

Dies leitet den Pin aus dem veröffentlichten Paket ab, sodass er korrekt bleibt, während der Server aktualisiert wird. Playwright muss fixiert werden: Ein nacktes npx playwright install chromium löst sich auf die neueste Version von Playwright auf, die eine Chromium-Version installieren kann, die der Server nicht unterstützt.

note

An eine ältere axe-mcp-server fixiert oder offline? Der obige Befehl liest die Abhängigkeit der neueste veröffentlichten Version. Wenn Sie eine fixierte ältere Version ausführen, ersetzen Sie sie stattdessen durch deren Playwright-Version — npm view axe-mcp-server@<version> dependencies.playwright — oder entnehmen Sie dies dem Chromium-Startfehler, der den genauen Befehl für den Server nennt, den Sie tatsächlich ausführen. Zum Zeitpunkt des Schreibens liefert die Server-Version 1.4.0 Playwright 1.61.1 aus.

Unter Windows cmd.exe, das keine $(...)-Ersetzung hat, führen Sie npm view axe-mcp-server dependencies.playwright alleine aus und fügen Sie die Version in den Befehl ein. PowerShell, Git Bash und WSL verarbeiten den Befehl wie geschrieben.

Siehe Fehlerbehebung bei der Chromium-Installation, wenn 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?