Browser Manager MCP Server
Browser Manager MCP Server est un serveur MCP (Model Context Protocol) dédié à la gestion et à l'automatisation des navigateurs web.
Il offre une interface complète pour contrôler les navigateurs, gérer les onglets, interagir avec les pages web et exécuter des tâches d'automatisation. Il s'agit d'une combinaison élégante des outils de Google et de Microsoft, libre et flexible pour naviguer facilement dans n'importe quel navigateur et sur n'importe quel onglet.
Fonctionnalités
- Gestion complète des navigateurs (lancement, fermeture, détection)
- Manipulation des onglets (liste, création, fermeture, navigation)
- Automatisation des interactions web (clics, saisie de texte, captures d'écran)
- Streaming HTTP pour les communications en temps réel
- Authentification optionnelle via token Bearer
🛠️ Outils Disponibles
Le serveur browser-manager-mcp-server fournit les outils suivants :
Gestion des Navigateurs
launch_browser- Lance un nouveau navigateurlist_browsers- Liste tous les navigateurs (gérés et externes) avec leurs ongletsclose_browser- Ferme un navigateurdetect_open_browsers- Détecte les navigateurs ouverts sur le système
Gestion des Onglets
list_tabs- Liste les onglets ouvertsselect_tab- Sélectionne un ongletnew_tab- Ouvre un nouvel ongletclose_tab- Ferme un onglet
Navigation et Interaction
navigate- Navigue vers une URLclick- Clique sur un élémenttype_text- Tape du texte dans un champwait_for- Attend du texte ou un délai
Analyse et Capture
get_html- Récupère le HTML de la pageget_console_logs- Récupère les logs consolescreenshot- Prend une capture d'écranevaluate_script- Exécute du JavaScript
Outils Avancés
Prérequis
- Node.js : Version 24.0.2 ou supérieure
- npm : Version 11.3.0 ou supérieure (recommandé)
Installation
-
Téléchargement du projet :
# clonez le dépôt complet git clone https://github.com/Jboner-Corvus/Browser-Manager-MCP-Server.git # Entrez dans le dossier dist cd "Browser-Manager-MCP-Server\dist" -
Installation des dépendances :
npm install --production -
Configuration de l'environnement :
- Le fichier
.envest déjà présent avec les valeurs par défaut - Modifiez les variables d'environnement dans
.envselon vos besoins si nécessaire
- Le fichier
Démarrage
Méthode recommandée (Windows)
Utilisez le script PowerShell fourni :
.\start-prod.ps1
Démarrage manuel
node server.js
Utilisation
🔌 Installation de l'Extension Browser Manager MCP Bridge
Pour contrôler les navigateurs externes (déjà ouverts), vous devez installer l'extension Chrome incluse.
Installation de l'extension :
L'extension est déjà compilée et prête à être chargée. Pour l'installer :
-
Ouvrez le gestionnaire d'extensions :
- Comet (Perplexity) :
comet://extensions/ - Chrome :
chrome://extensions/ - Brave :
brave://extensions/ - Edge :
edge://extensions/
- Comet (Perplexity) :
-
Activez le Mode développeur :
- Cochez "Mode développeur" (en haut à droite)
-
Chargez l'extension non empaquetée :
- Cliquez sur "Charger l'extension non empaquetée"
- Sélectionnez le dossier
dist/extension - L'extension devrait s'installer automatiquement
-
Vérifiez l'installation :
- L'icône de l'extension devrait apparaître dans la barre d'outils
- Cliquez dessus pour ouvrir l'interface de connexion
Utilisation de l'extension :
- L'extension permet de connecter le serveur MCP aux navigateurs externes
- Elle utilise un WebSocket relay sur le port 8082
- Supporte Brave, Chrome, Edge et autres navigateurs Chromium
Test de l'extension :
Pour vérifier que l'extension fonctionne correctement :
- Démarrez le serveur MCP avec
.\start-prod.ps1 - Ouvrez un navigateur (Brave, Chrome, etc.) avec quelques onglets
- Cliquez sur l'icône de l'extension dans la barre d'outils
- Sélectionnez un onglet à contrôler depuis l'interface
- Testez avec un client MCP (Claude Desktop, etc.) en utilisant les outils comme
list_external_browser_tabs
Indicateurs de bon fonctionnement :
- ✅ L'icône de l'extension affiche un badge vert "✓" sur l'onglet connecté
- ✅ Les outils MCP peuvent lister et contrôler les onglets externes
- ✅ Aucune erreur dans la console développeur de l'extension
- ✅ Le WebSocket relay (port 8082) est accessible
Endpoints API
Le serveur MCP fonctionne avec FastMCP 3.19.1 et propose deux endpoints principaux :
-
Endpoint MCP principal :
http://localhost:8081/mcp- Protocole : HTTP Stream (JSON-RPC)
- Usage : Communication directe avec le protocole MCP
- Authentification : Bearer Token (si configuré)
-
Endpoint SSE :
http://localhost:8081/sse- Protocole : Server-Sent Events (Streaming)
- Usage : Connexions en temps réel et streaming
- Authentification : Bearer Token (si configuré)
Modes de Transport
Le serveur supporte trois modes de transport :
-
HTTP Stream (par défaut) :
node lib/server.js- Endpoint principal :
/mcp - Endpoint SSE :
/sse - Idéal pour les applications web et APIs
- Endpoint principal :
-
Mode stdio :
MCP_TRANSPORT=stdio node lib/server.js- Usage : Intégration avec les clients MCP (Qoder, Claude Desktop, etc.)
- Communication via entrée/sortie standard
-
Mode SSE :
MCP_TRANSPORT=sse node lib/server.js- Endpoint :
/mcp(redirige vers le streaming SSE) - Usage : Applications nécessitant du streaming pur
- Endpoint :