Choisir une distribution

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

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é.

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 Un version LTS active de Node.js
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:latest

C'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@1.60.0 install chromium
note

Fixez Playwright à la version livrée par le serveur axe MCP — actuellement 1.60.0. Une npx playwright install chromium simple résout la dernière version de Playwright, qui peut installer une révision de Chromium non prise en charge par le serveur. Cette épinglette peut changer à chaque nouvelle version du serveur ; l'erreur de démarrage liée à Chromium vous indique 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

  1. Configurer l'authentification — une clé API ou OAuth 2.0
  2. Configurez votre client — VS Code avec Copilot, Cursor, ou Claude Code

Is this page helpful?

Help us improve this page

Still need help?