Een Distributie Kiezen
De axe MCP Server wordt geleverd in twee distributies. Beide bieden dezelfde analyze, remediate, en igt tools en respecteren dezelfde configuratie — ze verschillen alleen in de manier waarop de server op uw machine draait. Kies degene die het beste bij uw omgeving past; geen van beide heeft de voorkeur.
Docker vs. npm
| Docker | npm | |
|---|---|---|
| Runtime | Een Docker-container | Een Node.js-proces op uw host, op aanvraag gestart 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 localhost |
Heeft nodig --add-host; zie ERR_CONNECTION_REFUSED |
Bereikt host localhost services direct |
| 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 — uw MCP-client start de container op aanvraag met behulp van de configuratie in uw klantopstellinggids.
npm
Er is geen aparte installatiestap voor de server zelf — npx -y axe-mcp-server downloadt en voert het op aanvraag uit, en uw MCP-client roept dat commando voor u aan (zie uw klantopstellinggids).
De npm-distributie draait op Node.js. Gebruik een actieve Node.js LTS-release — oudere releases worden mogelijk niet ondersteund.
Installeer Chromium
Omdat de server een echte browser gebruikt om scans uit te voeren, moet u zelf een bijbehorende 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 kale npx playwright install chromium verwijst naar de laatste release van Playwright, die een Chromium-revisie kan installeren die de server niet ondersteunt. Deze pin kan veranderen tussen serverreleases; de Chromium-gerelateerde opstartfout wijst u op Problemen Oplossen bij Chromium-installatie als de versies afwijken.
Op Linux heeft u mogelijk ook de systeemlibs nodig waarvan Chromium afhankelijk is. Raadpleeg Problemen oplossen bij Chromium-installatie voor details.
Alternatief: gebruik een browser die je al hebt
Als je al een compatibele Chrome/Chromium-binary op je machine hebt, kun je de Playwright-installatie overslaan en in plaats daarvan de server daarop richten door de AXE_CHROME_PATH omgevingsvariabele in te stellen. Dit is alleen beschikbaar met de npm-distributie — de Docker-afbeelding gebruikt altijd zijn meegeleverde browser. Zie AXE_CHROME_PATH voor vereisten en aandachtspunten.
Volgende stappen
- Authenticatie instellen — een API-sleutel of OAuth 2.0
- Configureer je client — VS Code met Copilot, Cursor, of Claude Code
