Choisir une distribution
Le serveur axe MCP est livré en deux distributions. Les deux exposent le même analyze, remediate et igt outils et respectent le même configuration — ils ne diffèrent que par la manière dont le serveur fonctionne sur votre machine. Choisissez celui qui convient à votre environnement ; aucun des deux n'est préféré.
Les deux distributions supposent que vous pouvez accéder aux registres publics, npmjs.org et Docker Hub. Si votre réseau en restreint l'accès, consultez Installation depuis l'Agora de Deque à la place.
Docker contre npm
| Docker | npm | |
|---|---|---|
| Exécution | Un conteneur Docker | Un processus Node.js sur votre hôte, lancé à la demande avec npx |
| Navigateur | Inclus dans l'image | Installez Chromium via Playwright ou pointez vers un binaire Chrome/Chromium existant que vous avez déjà |
| Prérequis | Docker installé et en cours d'exécution | Node.js 22.19.0 ou ultérieure |
Atteindre localhost |
Nécessite --add-host ; voir ERR_CONNECTION_REFUSED |
Atteint directement les services hôtes localhost |
| Idéal quand | Vous utilisez déjà Docker et souhaitez un environnement autonome | Vous ne pouvez pas exécuter Docker, ou préférez un processus local plus léger |
Docker
Tirez l'image au départ, et chaque fois que vous souhaitez passer à une nouvelle version :
docker pull dequesystems/axe-mcp-server:latestC'est la seule étape d'installation — votre client MCP lance le conteneur à la demande en utilisant la configuration de votre guide de configuration du client.
npm
Il n'y a pas d'étape d'installation séparée pour le serveur lui-même — npx -y axe-mcp-server le télécharge et l'exécute à la demande, et votre client MCP invoque cette commande pour vous (voir votre guide de configuration du client).
La distribution npm fonctionne sur Node.js. Utilisez une version LTS active de Node.js — les versions plus anciennes pourraient ne pas être prises en charge.
Installer Chromium
Étant donné que le serveur utilise un vrai navigateur pour effectuer des analyses, vous devez installer vous-même une version correspondante de Chromium via Playwright :
npx playwright@$(npm view axe-mcp-server dependencies.playwright) install chromiumCela dérive le verrouillage du paquet publié, afin qu'il reste correct lorsque le serveur se met à jour. Playwright doit être verrouillé : un npx playwright install chromium nu résout la dernière version de Playwright, qui peut installer une révision de Chromium non prise en charge par le serveur.
Verrouillé sur une ancienne axe-mcp-server, ou hors ligne ? La commande ci-dessus lit la dépendance de la dernière publication publiée. Si vous exécutez une version plus ancienne verrouillée, remplacez-la par sa version de Playwright — npm view axe-mcp-server@<version> dependencies.playwright — ou prenez-la de l'erreur de démarrage de Chromium, qui nomme la commande exacte pour le serveur que vous exécutez réellement. Au moment de la rédaction, la version 1.4.0 du serveur inclut Playwright 1.61.1.
Sous Windows cmd.exe, qui n'a pas de $(...) de substitution, exécutez npm view axe-mcp-server dependencies.playwright seul et collez la version dans la commande. PowerShell, Git Bash et WSL gèrent la commande telle qu'elle est écrite.
Consultez Résolution des problèmes d'installation de Chromium si les versions divergent.
Sur Linux, vous pourriez également avoir besoin des bibliothèques système dont dépend Chromium. Voir Résolution des problèmes d'installation de Chromium pour plus de détails.
Alternative : utilisez un navigateur que vous avez déjà
Si vous disposez déjà d'un binaire Chrome/Chromium compatible sur votre machine, vous pouvez sauter l'installation de Playwright et diriger le serveur vers celui-ci en définissant la variable d'environnement AXE_CHROME_PATH. Cette option est uniquement disponible avec la distribution npm — l'image Docker utilise toujours son navigateur intégré. Voir AXE_CHROME_PATH pour les exigences et les mises en garde.
Prochaines étapes
- Configurer l'authentification — une clé API ou OAuth 2.0
- Configurez votre client — VS Code avec Copilot, Cursor, ou Claude Code