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.
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 | Een actieve Node.js LTS-release |
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@1.60.0 install chromiumPin Playwright aan de versie die de axe MCP Server levert — momenteel 1.60.0. Een losse npx playwright install chromium lost op naar de laatste release van Playwright, wat een Chromium-revisie kan installeren die de server niet ondersteunt. Deze pin kan veranderen bij serverreleases; de met Chromium gerelateerde opstartfout wijst je op Problemen oplossen bij Chromium-installatie als de versies afwijken.
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
