Install
code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'Pour qui
Si vous voulez qu’un grand modèle pilote un navigateur, et que le chemin par défaut soit les données d’accessibilité structurées de Puppeteer plutôt qu’un modèle de vision dès le départ, ce serveur correspond. Le texte officiel le décrit comme un service MCP léger qui donne aux modèles une capacité d’automatisation du navigateur, plus un mode vision optionnel pour les mises en page complexes et les éléments visuels.
Il convient à qui a déjà Node.js 18 ou plus récent et utilise VS Code, Cursor, Windsurf ou Claude Desktop. Sans Node.js 18+, ou si le client ne peut pas ajouter un MCP de type command, ne le branchez pas encore.
Ce n’est pas un résumé de page en lecture seule : l’automatisation démarre ou attache un navigateur, lit l’arbre d’accessibilité, et peut traiter des informations visuelles plus lourdes en mode vision. Le texte officiel dit que le défaut n’a pas besoin de modèle de vision et consomme surtout des données structurées, mais le réseau sortant et un processus navigateur local sont tous deux présents.
Réussir le premier essai en 3 minutes
Le chemin officiel recommandé est de lancer @agent-infra/mcp-server-browser avec npx. Prérequis : Node.js 18 ou plus récent est déjà installé sur cette machine.
Dans VS Code, la commande officielle est :
code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'
Cela enregistre un MCP nommé browser, commande npx, argument @agent-infra/mcp-server-browser@latest. Ensuite, rechargez le client et confirmez que le service browser est connecté.
Puis faites un appel à faible risque : utilisez la capacité d’automatisation fournie par ce service browser, restez sur le chemin par défaut des données d’accessibilité structurées, et n’ouvrez pas le mode vision. Les pages officielles n’écrivent pas de noms d’outils précis, de paramètres ni d’URL d’exemple ; n’appelez donc que les outils que le client affiche pour ce service browser. N’inventez pas de noms d’outils absents, et n’inventez pas d’URL à ouvrir. Signal de succès : le client affiche browser comme connecté, et renvoie un résultat structuré basé sur l’arbre d’accessibilité, pas une capture visuelle.
Le texte officiel montre aussi une forme command sous Cursor Settings -> MCP -> Add new MCP Server, ainsi qu’un démarrage distant avec --port 8089 ; au premier essai, suivez seulement la commande VS Code ci-dessus. N’ouvrez pas un second chemin en parallèle.
Cas d’usage
Cas 1 : automatiser le navigateur avec les données d’accessibilité structurées par défaut. Le texte officiel dit qu’il donne aux modèles une capacité navigateur via les données d’accessibilité structurées de Puppeteer, sans modèle de vision, et consomme surtout des données structurées pour réduire le contexte. Utilisez ce chemin quand le modèle doit comprendre les contrôles et la structure textuelle d’une page. Aucun outil précis ni site d’exemple n’est nommé ; à l’appel, n’utilisez que les outils affichés par le client et appartenant au service browser, et tenez le succès pour l’obtention de données d’accessibilité structurées.
Cas 2 : si les données structurées ne suffisent pas, envisager alors le mode vision optionnel. Le texte officiel dit que le mode vision sert aux mises en page complexes et aux éléments visuels, et qu’il est optionnel. Il n’explique ni comment l’activer, ni quel modèle il faut, ni s’il y a écriture disque ; vous ne pouvez donc que confirmer l’existence d’une capacité vision optionnelle. N’en faites pas une étape obligatoire du premier essai, et ne supposez pas un risque zéro. Si le client n’a pas d’explication d’interrupteur vision séparée, c’est que la page officielle n’a pas entièrement décrit l’activation ; restez sur le chemin des données structurées.
Limites
Le prérequis est Node.js 18+. Les clients nommés officiellement sont VS Code, Cursor, Windsurf, Claude Desktop. Un démarrage distant peut utiliser npx @agent-infra/mcp-server-browser --port 8089, et aussi passer DISPLAY=:0 pour VNC ou un affichage virtuel ; ce n’est pas le chemin principal du premier essai.
L’automatisation sort sur le réseau, contrôle le navigateur, peut ouvrir une page que vous indiquez, et laisse des traces de navigation sur cette machine. Le mode vision optionnel n’intervient que si les données structurées manquent ; le texte officiel ne le décrit ni comme sans réseau ni comme sans lecture locale.
Le texte officiel n’indique ni limite de débit, ni annulation, ni rollback. Fermer la fenêtre du navigateur ou arrêter le processus npx est l’interruption que vous pouvez faire ; pour une navigation ou une saisie déjà survenue sur la page, il n’y a pas d’annulation en un clic.