Een Distributie Kiezen
De axe MCP Server wordt geleverd in twee distributies. Beide geven dezelfde analyze, remediate en igt tools bloot en respecteren dezelfde configuratie — ze verschillen alleen in hoe de server op je machine draait. Kies degene die het beste bij je omgeving past; geen van beide heeft de voorkeur.
Beide distributies gaan ervan uit dat je toegang hebt tot de openbare registers, npmjs.org en Docker Hub. Als je netwerk de toegang tot deze sites beperkt, zie dan Installeren vanuit Deque's Agora.
Docker vs. npm
| Docker | npm | |
|---|---|---|
| Runtime | Een Docker-container | Een Node.js-proces op je host, gestart op aanvraag met npx |
| Browser | Ingebouwd in de afbeelding | Installeer Chromium via Playwright, of wijs naar een bestaande Chrome/Chromium-binary die u al hebt |
| Vereiste | Docker geïnstalleerd en draaiend | Node.js 22.19.0 of later |
Bereiken van localhost |
Vereist --add-host; zie ERR_CONNECTION_REFUSED |
Bereikt direct host localhost-diensten |
| Beste wanneer | U al Docker gebruikt en een zelfvoorzienende omgeving wilt | U Docker niet kunt draaien, of de voorkeur geeft aan een lichtere lokale proces |
Docker
Haal het beeld initieel binnen, en elke keer wanneer u naar een nieuwere release wilt overstappen:
docker pull dequesystems/axe-mcp-server:latestDat is de enige installatiestap — je MCP-client start de container op aanvraag met behulp van de configuratie in je klantopstellinggids.
npm
Er is geen afzonderlijke installatiestap voor de server zelf — npx -y axe-mcp-server downloadt en start deze op aanvraag, en je MCP-client roept dat commando voor je aan (zie je klantopstellinggids).
De npm-distributie draait op Node.js. Gebruik een actieve Node.js LTS-release — oudere versies worden mogelijk niet ondersteund.
Installeer Chromium
Omdat de server een echte browser gebruikt om scans uit te voeren, moet je zelf een bijpassende Chromium-build installeren via Playwright:
npx playwright@$(npm view axe-mcp-server dependencies.playwright) install chromiumDit leidt de pin af van het gepubliceerde pakket, zodat het correct blijft terwijl de server wordt bijgewerkt. Playwright moet worden vastgezet: een kale npx playwright install chromium leidt naar de nieuwste release van Playwright, wat kan resulteren in de installatie van een Chromium-revisie die de server niet ondersteunt.
Gepind naar een oudere axe-mcp-server, of offline? Het bovenstaande commando leest de afhankelijkheid van de laatste gepubliceerde release. Als je een vastgezette oudere versie gebruikt, vervang dan door de Playwright-versie die je gebruikt — npm view axe-mcp-server@<version> dependencies.playwright — of haal deze uit de Chromium-startfout, die het exacte commando bevat voor de server die je daadwerkelijk draait. Op het moment van schrijven levert server versie 1.4.0 Playwright 1.61.1.
Op Windows cmd.exe, die geen $(...) vervanging heeft, voer npm view axe-mcp-server dependencies.playwright apart uit en plak de versie in het commando. PowerShell, Git Bash en WSL verwerken het commando zoals geschreven.
Zie Problemen oplossen bij Chromium-installatie als de versies uiteenlopen.
Op Linux heb je mogelijk ook de systeembibliotheken nodig waar Chromium van afhankelijk is. Zie Problemen oplossen bij Chromium-installatie voor details.
Alternatief: gebruik een browser die je al hebt
Als je al een compatibele Chrome/Chromium-binair op je machine hebt, kun je de Playwright-installatie overslaan en de server er in plaats daarvan naar laten verwijzen door de AXE_CHROME_PATH-omgevingsvariabele in te stellen. Dit is alleen beschikbaar bij de npm-distributie — het Docker-image gebruikt altijd zijn meegeleverde browser. Zie AXE_CHROME_PATH voor vereisten en kanttekeningen.
Volgende stappen
- Authenticatie instellen — een API-sleutel of OAuth 2.0
- Configureer je client — VS Code met Copilot, Cursor of Claude Code