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