Note di rilascio di Axe MCP Server Versione 1.4.0
Data di rilascio
28 luglio 2026
Panoramica
Questa versione v1.4.0 introduce Regole avanzate nello strumento analyze e aggiunge un screenshot della pagina opzionale alla risposta analyze per permetterti di vedere cosa è stato scansionato.
Per ottenere questa versione:
- Docker — ri-pull dell'immagine:
docker pull dequesystems/axe-mcp-server:latest - npm — non è richiesto alcun passaggio di installazione separato;
npxesegue l'ultima versione pubblicata. Vedi Scegliere una Distribuzione.
Nuove Funzionalità
Regole Avanzate nello Strumento analyze
Il strumento analyze ora esegue Regole avanzate accanto al set di regole standard di axe-core. Queste regole utilizzano screenshot, visione artificiale e modelli di linguaggio di grandi dimensioni per trovare problemi che axe-core da solo non può rilevare — intestazioni che sembrano solo intestazioni, immagini informative con testo alternativo poco utile, e contrasto di testo su gradienti o immagini. I risultati avanzati vengono integrati nello stesso array di risultati che il tuo agente già consuma, quindi non è necessario alcun cambiamento ai tuoi prompt o workflow.
Screenshot della Pagina nello Strumento analyze
Il strumento analyze ora accetta un parametro screenshot opzionale che restituisce un'immagine della pagina insieme al rapporto di violazione, come blocco standard di contenuto immagine MCP.
La cattura copre il viewport visibile nel momento appena prima dell'inizio della scansione — passa un alto viewportHeight per vedere più della pagina. La cattura è al massimo delle possibilità e non causa mai il fallimento di una scansione: se il tempo scade, i risultati vengono comunque restituiti con una nota in messages. E se il scansione fallisce dopo che lo screenshot è stato preso, l'immagine è restituita con la risposta di errore, fornendo lo stato visivo della pagina nel momento in cui le cose sono andate storte.
Richiedi screenshot deliberatamente piuttosto che a ogni scansione — un blocco di immagini costa token di input immagine al turno successivo dell'agente, circa un ordine di grandezza in più rispetto al testo equivalente.
Il modo in cui l'immagine viene visualizzata in linea dipende dal tuo client MCP: VS Code con Copilot lo visualizza, mentre Cursor e Claude Desktop possono collassare il risultato dello strumento o omettere l'anteprima. Il server restituisce sempre un blocco immagine valido secondo le specifiche, quindi un'anteprima mancante è una limitazione di visualizzazione lato client piuttosto che una cattura non riuscita.
Vedi Screenshot per tutti i dettagli.
Modifiche
Il viewport di scansione predefinito è ora 1000×1080
Quando viewportWidth e viewportHeight sono entrambi omessi, analyze ora scansiona a 1000×1080 invece della dimensione predefinita del viewport del browser. Questo rende i risultati riproducibili su più distribuzioni e ambienti, e corrisponde alla larghezza utilizzata dalle Regole Avanzate per l'analisi dell'immagine — evitando un ridimensionamento con perdita dello screenshot catturato.
Se le tue scansioni dipendevano dal precedente viewport implicito, imposta viewportWidth e viewportHeight esplicitamente. Vedi Test reattivi.
Correzioni di bug
- I token OAuth scaduti ora spiegano come recuperare. Quando un token di accesso scade a metà sessione, l'errore che il tuo agente riceve indica la soluzione — ri-autenticarsi con
@deque/axe-authe riavviare la connessione al server — invece di mostrare un rifiuto opaco dal backend. Vedi Errori di autenticazione. - Risolto
AXE_CHROME_PATHsu Windows (distribuzione npm). PuntareAXE_CHROME_PATHsu un Chrome valido per il test binario causava il crash all'avvio su Windows conUnable to find specified chrome instance, poiché il controllo di avvio richiedeva chechrome.exe --versionterminasse correttamente — cosa che non avviene in modo affidabile su Windows. Il percorso è ora validato dalla sua esistenza su Windows. Percorsi non validi o mancanti causano ancora un fallimento all'avvio su ogni piattaforma. VediAXE_CHROME_PATH.