Skip to main content
Glama
randyrt

Chrome MCP Bridge

by randyrt
README.md
# Chrome MCP Bridge

Connecte des assistants IA (Claude, etc.) à votre navigateur Chrome via le **Model Context Protocol (MCP)**.

## Architecture

```
Claude Desktop / AI Client
        │
        │ MCP Protocol (stdio)
        ▼
  [MCP Server (Node.js)]
        │
        │ WebSocket (ws://localhost:PORT)
        ▼
  [Chrome Extension]
        │
        │ Chrome APIs
        ▼
    [Browser]
```

## Outils disponibles

| Outil | Description |
|---|---|
| `browser_navigate` | Navigue vers une URL |
| `browser_screenshot` | Capture la page active |
| `browser_click` | Clique sur un sélecteur CSS |
| `browser_fill` | Remplit un champ de formulaire |
| `browser_get_content` | Récupère le HTML/texte de la page |
| `browser_list_tabs` | Liste tous les onglets ouverts |

## Installation

### 1. Serveur MCP

```bash
npx chrome-mcp-bridge
```

Ou installation globale :

```bash
npm install -g chrome-mcp-bridge
chrome-mcp-bridge
```

### 2. Extension Chrome

1. Ouvrez `chrome://extensions`
2. Activez le **Mode développeur**
3. Cliquez sur **Charger l'extension non empaquetée**
4. Sélectionnez le dossier `extension/dist`

### 3. Configuration Claude Desktop

Ajoutez dans `claude_desktop_config.json` :

```json
{
  "mcpServers": {
    "chrome-bridge": {
      "command": "npx",
      "args": ["chrome-mcp-bridge"],
      "env": {
        "WS_PORT": "9009"
      }
    }
  }
}
```

## Développement

```bash
# Installer les dépendances
npm install

# MCP Server
cd mcp-server && npm run dev

# Extension
cd extension && npm run dev
```