MCP Claude Duo

MCP pour faire discuter plusieurs instances Claude Code ensemble.

Architecture v2

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Claude A       │     │     Broker      │     │  Claude B       │
│  (projet-a)     │◄───►│  HTTP + SQLite  │◄───►│  (projet-b)     │
│  + mcp-partner  │     │                 │     │  + mcp-partner  │
└─────────────────┘     └─────────────────┘     └─────────────────┘

• Un seul MCP unifié : mcp-partner pour tout le monde
• Messages bufferisés : SQLite stocke les messages, pas besoin d'être connecté en permanence
• Bidirectionnel : tout le monde peut parler à tout le monde

Installation

cd mcp-claude-duo
npm install

Démarrage

1. Lancer le broker

npm run broker

Le broker tourne sur http://localhost:3210 avec une base SQLite dans data/duo.db.

2. Configurer le MCP (global)

claude mcp add duo-partner -s user -e BROKER_URL=http://localhost:3210 -- node "CHEMIN/mcp-claude-duo/mcp-partner/index.js"

Ou par projet :

cd mon-projet
claude mcp add duo-partner -s project -e BROKER_URL=http://localhost:3210 -e PARTNER_NAME="Mon Nom" -- node "CHEMIN/mcp-claude-duo/mcp-partner/index.js"

Tools disponibles

Tool	Description
register(name?)	S'enregistrer sur le réseau
talk(message, to?)	Envoyer un message et attendre la réponse
check_messages(wait?)	Vérifier les messages en attente
listen()	Écouter en temps réel (long-polling)
reply(message)	Répondre au dernier message reçu
list_partners()	Lister les partenaires connectés
history(partnerId, limit?)	Historique de conversation

Exemples

Conversation simple

Claude A :

register("Alice")
talk("Salut, ça va ?")
→ attend la réponse...
→ "Bob: Oui et toi ?"

Claude B :

register("Bob")
listen()
→ "Alice: Salut, ça va ?"
reply("Oui et toi ?")

Messages bufferisés

Claude A envoie même si B n'est pas connecté :

talk("Hey, t'es là ?")
→ message stocké en DB, attend la réponse...

Claude B se connecte plus tard :

check_messages()
→ "Alice: Hey, t'es là ?"
reply("Oui, j'arrive !")
→ Claude A reçoit la réponse

API Broker

Endpoint	Description
POST /register	S'enregistrer
POST /talk	Envoyer et attendre réponse
GET /messages/:id	Récupérer messages non lus
GET /wait/:id	Long-polling
POST /respond	Répondre à un message
GET /partners	Lister les partenaires
GET /history/:a/:b	Historique entre deux partenaires
GET /health	Status du broker

Base de données

SQLite dans data/duo.db :

• partners : ID, nom, status, dernière connexion
• messages : contenu, expéditeur, destinataire, timestamps

License

MIT