brave-mcp

Wrapper MCP local pour piloter le navigateur Brave (et Chrome/Edge) via chrome-devtools-mcp, avec gestion multi-navigateurs, sessions utilisateur réelles et reconnexion automatique.

Ce serveur ne crée pas de profil isolé : il se connecte au navigateur natif avec votre profil utilisateur (sessions, cookies, comptes déjà connectés).

Fonctionnement

start.js démarre un serveur MCP qui s'appuie sur la librairie officielle chrome-devtools-mcp (Puppeteer) pour les ~29 outils standards de navigation, et ajoute des outils de gestion du cycle de vie du navigateur :

Caractéristiques notables :

• Sessions utilisateur : le navigateur est lancé avec --remote-debugging-port sur son profil réel — pas de profil jetable.

• Port CDP dédié par navigateur : Chrome 9222, Brave 9223, Edge 9224.

• Reconnexion à chaud : browser_use met à jour la cible sans redémarrer le serveur.

• Health-check : toutes les 30 s, reconnexion automatique si le navigateur tombe.

• Anti-corruption du TUI : toute sortie console.log/debug est redirigée vers stderr pour garder stdout propre pour le protocole MCP (JSON-RPC).

Related MCP server: mcp-chromium-cdp

Prérequis

• Node.js >= 20 (vérifié au démarrage par start.js)

• Windows (détection des navigateurs via chemins standard, registre et where)

• Chrome, Brave ou Edge installé (au moins un)

Installation

git clone https://github.com/menoxz/brave-mcp.git
cd brave-mcp
npm install
npm start

Configuration MCP

opencode

Ajoutez dans votre opencode.json (fichier de config utilisateur ou projet) :

{
  "mcp": {
    "web-browser": {
      "type": "local",
      "command": [
        "node",
        "C:\\chemin\\vers\\brave-mcp\\start.js",
        "--usageStatistics=false",
        "--performanceCrux=false"
      ],
      "environment": {
        "DEBUG": ""
      },
      "enabled": true
    }
  }
}

Claude Desktop / autres clients MCP

{
  "mcpServers": {
    "web-browser": {
      "command": "node",
      "args": ["C:\\chemin\\vers\\brave-mcp\\start.js", "--usageStatistics=false", "--performanceCrux=false"]
    }
  }
}

Lancement manuel du navigateur

Le serveur peut lancer le navigateur lui-même (browser_launch), mais vous pouvez aussi le démarrer à la main :

# Brave sur le port 9222 (profil utilisateur)
.\launch-brave.ps1

# Chrome, Brave ou Edge (détection automatique)
.\launch-browser.ps1 -Browser Brave

Outils exposés

• Les outils standards de chrome-devtools-mcp (navigation, onglets, DOM, captures, etc. — ~29 outils).

• Les outils browser_* listés ci-dessus.

Licence

MIT — Jean-Luc KOUMAGLO (menoxz), 2026.

Le serveur s'appuie sur chrome-devtools-mcp (Google), distribué sous licence Apache-2.0.