Browser-Manager-MCP-Server

DeamonDev888/Browser-Manager-MCP-Server

3.2

If you are the rightful owner of Browser-Manager-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Browser Manager MCP Server is a specialized server for managing and automating web browsers using the Model Context Protocol.

Tools
16
Resources
0
Prompts
0

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

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

  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