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.
Entrambe le distribuzioni presuppongono che tu possa accedere ai registri pubblici, npmjs.org e Docker Hub. Se la tua rete limita l'accesso a questi, consulta Installazione da Agora di Deque.
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 | Node.js 22.19.0 o successivo |
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@$(npm view axe-mcp-server dependencies.playwright) install chromiumQuesto deriva il pin dal pacchetto pubblicato, quindi rimane corretto mentre il server si aggiorna. Playwright deve essere bloccato: un semplice npx playwright install chromium risolve l'ultima versione di Playwright, che può installare una revisione di Chromium che il server non supporta.
Bloccato a una vecchia versione di axe-mcp-server, o offline? Il comando sopra legge la dipendenza della versione ultima pubblicata. Se esegui una versione più vecchia bloccata, sostituisci la sua versione di Playwright — npm view axe-mcp-server@<version> dependencies.playwright — o ottienila dall'errore di avvio di Chromium, che indica il comando esatto per il server che stai effettivamente eseguendo. Al momento della stesura, la versione del server 1.4.0 include Playwright 1.61.1.
Su Windows cmd.exe, che non ha nessuna sostituzione di $(...), esegui npm view axe-mcp-server dependencies.playwright da solo e incolla la versione nel comando. PowerShell, Git Bash e WSL gestiscono il comando come è scritto.
Consulta Risoluzione problemi installazione di Chromium se le versioni divergono.
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