Scelta di una Distribuzione
Il server Axe MCP è disponibile in due distribuzioni. Entrambe espongono gli stessi analyze, remediate e strumenti igt e rispettano gli stessi configurazione: differiscono solo nel modo in cui il server viene eseguito sulla tua macchina. Scegli quella che si adatta al tuo ambiente; nessuna è preferibile.
Docker vs. npm
| Docker | npm | |
|---|---|---|
| Runtime | Un container Docker | Un processo Node.js sul tuo host, lanciato su richiesta con npx |
| Browser | Incluso nell'immagine | Installa Chromium tramite Playwright, oppure imposta un binario Chrome/Chromium esistente che già possiedi |
| Prerequisito | Docker installato e in esecuzione | Un rilascio LTS Node.js attivo |
Raggiungere localhost |
Richiede --add-host; vedi ERR_CONNECTION_REFUSED |
Raggiunge direttamente i servizi host localhost |
| Ideale quando | Utilizzi già Docker e vuoi un ambiente autonomo | Non puoi eseguire Docker, o preferisci un processo locale più leggero |
Docker
Scarica l'immagine inizialmente e ogni volta che desideri passare a una versione più recente:
docker pull dequesystems/axe-mcp-server:latestQuesto è l'unico passaggio di installazione: il tuo client MCP lancia il container su richiesta usando la configurazione nel tuo guida per la configurazione del client.
npm
Non c'è un passaggio di installazione separato per il server stesso: npx -y axe-mcp-server lo scarica e lo esegue su richiesta, e il tuo client MCP invoca quel comando per te (vedi il tuo guida per la configurazione del client).
La distribuzione npm funziona su Node.js. Usa un release LTS attiva di Node.js — le versioni precedenti potrebbero non essere supportate.
Installa Chromium
Poiché il server usa un browser reale per eseguire le scansioni, devi installare tu stesso una build Chromium corrispondente tramite Playwright:
npx playwright@1.60.0 install chromiumBlocca Playwright alla versione con cui il server Axe MCP è distribuito, attualmente 1.60.0. Un semplice npx playwright install chromium risolve l'ultima release di Playwright, che potrebbe installare una revisione di Chromium non supportata dal server. Questo blocco può cambiare con le versioni del server; l'errore di avvio relativo a Chromium ti indicherà Risoluzione problemi installazione di Chromium se le versioni non coincidono.
Su Linux, potresti aver bisogno anche delle librerie di sistema da cui dipende Chromium. Vedi Risoluzione problemi installazione di Chromium per i dettagli.
Alternativa: utilizza un browser che hai già
Se hai già un binario Chrome/Chromium compatibile sulla tua macchina, puoi saltare l'installazione di Playwright e puntare il server direttamente a esso impostando la variabile d'ambiente AXE_CHROME_PATH. Questo è disponibile solo con la distribuzione npm — l'immagine Docker usa sempre il browser integrato. Vedi AXE_CHROME_PATH per requisiti e avvertenze.
Passi successivi
- Imposta l'autenticazione — una chiave API o OAuth 2.0
- Configura il tuo client — VS Code con Copilot, Cursor o Claude Code