# brave-mcp

Wrapper MCP local pour piloter le navigateur **Brave** (et Chrome/Edge) via
[`chrome-devtools-mcp`](https://github.com/ChromeDevTools/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 :

| Outil | Rôle |
|-------|------|
| `browser_list` | Liste les navigateurs Chromium installés (Chrome, Brave, Edge) avec leur statut CDP |
| `browser_launch` | Lance un navigateur natif avec CDP et votre profil utilisateur |
| `browser_use` | Bascule la connexion vers un autre navigateur (sans redémarrage du serveur) |
| `browser_status` | Statut détaillé de la connexion CDP et pages ouvertes |
| `browser_restart` | Ferme un navigateur et le relance avec CDP + profil |

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

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

```bash
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) :

```jsonc
{
  "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

```json
{
  "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 :

```powershell
# 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](LICENSE) — Jean-Luc KOUMAGLO (menoxz), 2026.

Le serveur s'appuie sur [`chrome-devtools-mcp`](https://github.com/ChromeDevTools/chrome-devtools-mcp)
(Google), distribué sous licence Apache-2.0.