Browser Manager MCP Server

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 navigateur

• list_browsers - Liste tous les navigateurs (gérés et externes) avec leurs onglets

• close_browser - Ferme un navigateur

• detect_open_browsers - Détecte les navigateurs ouverts sur le système

Gestion des Onglets

• list_tabs - Liste les onglets ouverts

• select_tab - Sélectionne un onglet

• new_tab - Ouvre un nouvel onglet

• close_tab - Ferme un onglet

Navigation et Interaction

• navigate - Navigue vers une URL

• click - Clique sur un élément

• type_text - Tape du texte dans un champ

• wait_for - Attend du texte ou un délai

Analyse et Capture

• get_html - Récupère le HTML de la page

• get_console_logs - Récupère les logs console

• screenshot - Prend une capture d'écran

• evaluate_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

1. 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"

2. Installation des dépendances :

   npm install --production

3. Configuration de l'environnement :

   • Le fichier .env est déjà présent avec les valeurs par défaut

   • Modifiez les variables d'environnement dans .env selon vos besoins si nécessaire

Démarrage

Méthode recommandée (Windows)

Utilisez le script PowerShell fourni :

Démarrage manuel

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 :

1. Ouvrez le gestionnaire d'extensions :

   • Comet (Perplexity) : comet://extensions/

   • Chrome : chrome://extensions/

   • Brave : brave://extensions/

   • Edge : edge://extensions/

2. Activez le Mode développeur :

   • Cochez "Mode développeur" (en haut à droite)

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

4. 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 :

1. Démarrez le serveur MCP avec .\start-prod.ps1

2. Ouvrez un navigateur (Brave, Chrome, etc.) avec quelques onglets

3. Cliquez sur l'icône de l'extension dans la barre d'outils

4. Sélectionnez un onglet à contrôler depuis l'interface

5. 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 :

1. HTTP Stream (par défaut) : node lib/server.js

   • Endpoint principal : /mcp

   • Endpoint SSE : /sse

   • Idéal pour les applications web et APIs

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

3. Mode SSE : MCP_TRANSPORT=sse node lib/server.js

   • Endpoint : /mcp (redirige vers le streaming SSE)

   • Usage : Applications nécessitant du streaming pur