Scelta di una Distribuzione

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard
Not for use with personal data

Il server MCP di axe è disponibile in due distribuzioni. Entrambe rendono disponibili gli stessi analyze, remediate, e igt strumenti e rispettano la stessa 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, avviato 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
Raggiungimento localhost Richiede --add-host; vedi ERR_CONNECTION_REFUSED Raggiunge direttamente i localhost servizi host
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:latest

Questo è l'unico passaggio di installazione — il tuo client MCP avvia il container su richiesta utilizzando 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 la tua guida per la configurazione del client).

La distribuzione npm funziona su Node.js. Usa una release LTS attiva di Node.js — le versioni più vecchie potrebbero non essere supportate.

Installa Chromium

Poiché il server utilizza un vero browser per eseguire le scansioni, devi installare una versione di Chromium compatibile tramite Playwright:

npx playwright@1.60.0 install chromium
note

Fissa Playwright alla versione con cui il server MCP di axe viene fornito — attualmente 1.60.0. Un semplice npx playwright install chromium risolve all'ultima versione di Playwright, che può installare una revisione di Chromium non supportata dal server. Questa versione può cambiare tra i rilasci del server; l'errore di avvio relativo a Chromium ti indica Risoluzione dei problemi dell'installazione di Chromium se le versioni divergono.

Su Linux, potresti anche avere bisogno delle librerie di sistema da cui Chromium dipende. Vedi Risoluzione problemi installazione di Chromium per ulteriori dettagli.

Alternativa: utilizza un browser che hai già

Se hai già un binario compatibile di Chrome/Chromium sulla tua macchina, puoi saltare l'installazione di Playwright e puntare il server verso di esso impostando la variabile di ambiente AXE_CHROME_PATH . Questo è disponibile solo con la distribuzione npm — l'immagine Docker utilizza sempre il suo browser integrato. Vedi AXE_CHROME_PATH per requisiti e avvertenze.

Passi successivi

  1. Imposta l'autenticazione — una chiave API o OAuth 2.0
  2. Configura il tuo client — VS Code con Copilot, Cursor, o Claude Code

Is this page helpful?

Help us improve this page

Still need help?