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 les mêmes analyze, remediate, et igt outils et respectent la même configuration — elles diffèrent uniquement dans la manière dont le serveur fonctionne sur votre machine. Choisissez celle qui s'adapte à votre environnement ; aucune n'est préférée.

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 Une version LTS active de Node.js
Accès localhost Besoin de --add-host; voir ERR_CONNECTION_REFUSED Accède directement aux localhost services de l'hôte
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 à l'aide de 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 avec Node.js. Utilisez une version LTS active de Node.js — les versions plus anciennes peuvent ne pas être prises en charge.

Installer Chromium

Étant donné que le serveur utilise un navigateur réel pour exécuter les analyses, vous devez installer vous-même une version compatible de Chromium via Playwright:

npx playwright@1.60.0 install chromium
note

Fixez Playwright à la version qu'expédie le serveur axe MCP — actuellement 1.60.0. Une simple npx playwright install chromium se résout à la dernière version de Playwright, qui peut installer une révision de Chromium que le serveur ne prend pas en charge. Ce verrouillage peut changer selon les versions du serveur ; l'erreur de démarrage liée à Chromium vous indique vers Dépannage de l'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 avez déjà un binaire Chrome/Chromium compatible sur votre machine, vous pouvez passer l'installation de Playwright et pointer le serveur vers ce binaire en définissant la variable d'environnement AXE_CHROME_PATH . Cela est disponible uniquement avec la distribution npm — l'image Docker utilise toujours son navigateur intégré. Voir AXE_CHROME_PATH pour les exigences et 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?