overmind-mcp 2.2.1 → 2.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -30,129 +30,37 @@ Il transforme les outils CLI isolés en une force coordonnée, pilotable par API
30
30
 
31
31
  ---
32
32
 
33
- ## 🚀 Commencer (Guide Facile)
33
+ ## 🚀 Installation
34
34
 
35
- ### Option 1 : Installation Globale NPM (Recommandé)
35
+ ### Globale via NPM (Recommandé)
36
36
 
37
37
  ```bash
38
38
  npm install -g overmind-mcp@latest
39
39
  ```
40
40
 
41
- **🎯 Après Installation NPM :**
41
+ **🎯 Ce qui est installé automatiquement :**
42
42
 
43
- Une fois installé, vous avez 2 options :
43
+ 1. **Détection Docker** - Vérification que Docker Desktop est disponible
44
+ 2. **PostgreSQL + pgvector** - Container Docker avec extension vectorielle (si absent)
45
+ 3. **overmind-postgres-mcp** - Serveur MCP PostgreSQL vectoriel installé automatiquement
46
+ 4. **Configuration complète** - Fichiers .env et .mcp.json générés automatiquement
47
+ 5. **Base de données initialisée** - Tables OverMind créées automatiquement
44
48
 
45
- #### A. Mode Simple (Sans Docker - Recommandé pour débuter)
49
+ **✅ Installation ultra-simplifiée :**
50
+ - 📦 **Taille** : 1-5 GB (au lieu de 8 GB)
51
+ - ⚡ **Rapide** : ~15 secondes chrono
52
+ - 🎯 **Automatique** : Tout configuré pour vous
53
+ - 🛡️ **Sécurisé** - Vos containers personnels sont protégés
46
54
 
47
- OverMind fonctionne **immédiatement** sans infrastructure Docker :
55
+ ### Configuration MCP
48
56
 
49
- ```bash
50
- # Créer un agent simple
51
- overmind create-agent --name expert-python --runner claude --prompt "Tu es un expert Python..."
52
-
53
- # Lancer une analyse
54
- overmind run-agent --runner claude --prompt "Analyse ce code..."
55
- ```
56
-
57
- **✅ Avantages :**
58
- - Installation immédiate
59
- - Pas de Docker requis
60
- - Fonctionne tout de suite
61
- - Idéal pour tester et utiliser les features de base
62
-
63
- #### B. Mode Avancé (Avec Docker - Recommandé pour Production)
64
-
65
- Pour utiliser les **fonctionnalités avancées** (Swarm, Workflows long-running, Observabilité), vous avez besoin de l'infrastructure Docker.
66
-
67
- **Suivez le guide d'installation :**
68
- - 📄 [Guide d'installation rapide](https://github.com/DeamonDev888/overmind-mcp/blob/main/INSTALL.md)
69
- - 📄 [Guide de déploiement complet](https://github.com/DeamonDev888/overmind-mcp/blob/main/docs/guides/DEPLOYMENT.md)
70
-
71
- **🚀 Installation Docker Automatique :**
72
-
73
- L'installation **100% automatique** installe et configure **tout** pour vous :
74
-
75
- ```bash
76
- npm install -g overmind-mcp@latest
77
- ```
78
-
79
- **Ce qui est installé automatiquement :**
80
- - ✅ Docker Desktop (vérification)
81
- - ✅ PostgreSQL + pgvector (si absent)
82
- - ✅ **Toute** l'infrastructure Docker (RabbitMQ, Temporal, Prometheus, Grafana, Jaeger, Redis)
83
- - ✅ Configuration (.env, .mcp.json)
84
- - ✅ Validation de tous les services
85
-
86
- **Après installation, ouvrez Docker Desktop → onglet "Containers" pour voir tous les services.**
87
-
88
- **✅ Avantages du Mode Avancé :**
89
- - 🐳 RabbitMQ (Message Broker)
90
- - ⏱️ Temporal (Workflows long-running)
91
- - 📊 Observabilité (Prometheus, Grafana, Jaeger)
92
- - 🧠 Vector DB (PostgreSQL + pgvector)
93
-
94
- ---
95
-
96
- ### Option 2 : Installation Locale (Développement)
97
-
98
- Si vous souhaitez contribuer ou avoir la toute dernière version :
99
-
100
- ```bash
101
- # 1. Cloner le repo
102
- git clone https://github.com/DeamonDev888/overmind-mcp.git
103
- cd overmind-mcp
104
-
105
- # 2. Installer les dépendances
106
- pnpm install
107
-
108
- # 3. Build le projet
109
- pnpm run build
110
-
111
- # 4. Optionnel : Setup Windows automatique
112
- node scripts/setup-windows.js
113
- ```
114
-
115
- ---
116
-
117
- ## 🎯 Mode d'Emploi
118
-
119
- | Mode | Installation | Infrastructure | Features |
120
- |------|-------------|----------------|----------|
121
- | **Simple** | `npm install -g` | Aucune | OverMind base (agents, mémoire locale) |
122
- | **Avancé** | `npm install -g` + Docker | Docker Desktop | Toutes les features (Swarm, Workflows, Observabilité) |
123
- | **Dév** | Clone repo + `pnpm install` | Docker + PostgreSQL local | Toutes les features + accès au code source |
124
-
125
- **Recommandation :** Commencez par le **Mode Simple**, puis passez au **Mode Avancé** quand vous avez besoin des fonctionnalités avancées !
126
-
127
- ---
128
-
129
- ### Option 3 : Utilisation comme Bibliothèque
57
+ Pour utiliser OverMind dans votre IDE ou CLI préféré :
130
58
 
131
- Vous pouvez utiliser OverMind-MCP comme un module dans vos propres projets :
132
-
133
- ```typescript
134
- import { runAgent, AgentManager, createSwarmOrchestrator } from 'overmind-mcp';
135
-
136
- // 1. Initialisation
137
- const manager = new AgentManager();
138
- await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
139
-
140
- // 2. Lancer une analyse
141
- const { content, isError } = await runAgent({
142
- runner: 'claude',
143
- agentName: 'expert-seo',
144
- prompt: 'Analyse le site example.com',
145
- });
146
-
147
- // 3. Swarm Orchestration (mode avancé avec Docker)
148
- const swarm = createSwarmOrchestrator({
149
- agents: [...],
150
- tasks: [...],
151
- maxParallelTasks: 5,
152
- });
153
- ```
154
-
155
- ---
59
+ ```json
60
+ {
61
+ "mcpServers": {
62
+ "overmind": {
63
+ "command": "npx",
156
64
  "args": ["-y", "overmind-mcp@latest"]
157
65
  }
158
66
  }
@@ -161,45 +69,27 @@ const swarm = createSwarmOrchestrator({
161
69
 
162
70
  ---
163
71
 
164
- ### Option 2 : Installation Locale (Développement ou hébergement précis)
72
+ ## 🔧 Installation Locale (Dev)
73
+
74
+ Si vous souhaitez contribuer au projet :
165
75
 
166
76
  ```bash
167
- # 1. Cloner le repo localement
168
- git clone https://github.com/DeamonDev888/overmind-mcp overmind-mcp
77
+ # Cloner le repo
78
+ git clone https://github.com/DeamonDev888/overmind-mcp.git
169
79
  cd overmind-mcp
170
80
 
171
- # 2. Installer les dépendances
81
+ # Installer les dépendances
172
82
  pnpm install
173
83
 
174
- # 3. Build le projet
84
+ # Builder le projet
175
85
  pnpm run build
176
86
  ```
177
87
 
178
- Pour que l'agent puisse voir vos autres serveurs MCP locaux, copiez le fichier d'exemple :
179
-
180
- ```bash
181
- cp .mcp.json.example .mcp.json
182
- ```
183
-
184
- **Configuration MCP (Client) pour l'Option 2 :**
185
- Pour connecter ce runner à un client en pointant vers votre version locale compilée :
186
-
187
- ```json
188
- {
189
- "mcpServers": {
190
- "overmind": {
191
- "command": "node",
192
- "args": ["/LE_CHEMIN_ABSOLU_VERS_LE_DOSSIER_CLONE/dist/bin/cli.js"]
193
- }
194
- }
195
- }
196
- ```
197
-
198
88
  ---
199
89
 
200
- ## 📦 Utilisation comme Bibliothèque
90
+ ### Utilisation comme Bibliothèque
201
91
 
202
- Vous pouvez désormais importer le moteur du runner dans vos propres scripts :
92
+ Vous pouvez utiliser OverMind-MCP comme un module dans vos propres projets TypeScript/JavaScript :
203
93
 
204
94
  ```typescript
205
95
  import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
@@ -209,9 +99,9 @@ updateConfig('./settings.json', './mcp.local.json');
209
99
 
210
100
  // 2. Gestion des agents
211
101
  const manager = new AgentManager();
212
- await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude-4-6-sonnet');
102
+ await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
213
103
 
214
- // 3. Lancer une exécution via l'Orchestrateur Unifié
104
+ // 3. Lancer une exécution
215
105
  const { content, isError } = await runAgent({
216
106
  runner: 'claude',
217
107
  agentName: 'expert-seo',
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "overmind-mcp",
3
- "version": "2.2.1",
3
+ "version": "2.2.3",
4
4
  "preferGlobal": true,
5
5
  "description": "Orchestrateur universel agents IA multi-modeles via MCP. Inclut le protocole 'Custom-Nickname' pour identifier vos agents avec des surnoms originaux (The Chaos Prophet, Shadow Sniper, etc.), l'isolation mémoire (Private Memory Context) et le support pour QwenCli et Nous Hermes. Installation automatique des dépendances Docker (PostgreSQL, pgvector) inclus.",
6
6
  "type": "module",
@@ -329,24 +329,42 @@ EMBEDDING_CACHE_SIZE=1000
329
329
  }
330
330
 
331
331
  async function startPostgreSQL() {
332
- logSection('DÉMARRAGE POSTGRESQL + PGVECTOR');
332
+ logSection('VÉRIFICATION POSTGRESQL + PGVECTOR');
333
333
 
334
334
  try {
335
- const existingContainer = runCommand(
336
- 'docker ps --filter "name=overmind-postgres-pgvector" --format "{{.Names}}"',
335
+ // Vérifier si PostgreSQL existe déjà (n'importe quel container postgres)
336
+ const anyPostgres = runCommand(
337
+ 'docker ps --filter "name=postgres" --filter "publish=5432" --format "{{.Names}}"',
337
338
  { stdio: 'pipe' }
338
339
  );
339
340
 
340
- if (existingContainer) {
341
- log(COLORS.green, '✅ PostgreSQL + pgvector déjà démarré');
341
+ if (anyPostgres) {
342
+ log(COLORS.green, '✅ PostgreSQL déjà actif sur le port 5432');
343
+ log(COLORS.cyan, ' Container: ' + anyPostgres.trim());
344
+ log(COLORS.yellow, ' 💡 Utilisation de PostgreSQL existant (pas de création OverMind)');
342
345
  return true;
343
346
  }
344
347
 
345
- log(COLORS.yellow, '🚀 Démarrage PostgreSQL + pgvector...');
348
+ // Vérifier si le container OverMind existe déjà
349
+ const overmindContainer = runCommand(
350
+ 'docker ps -a --filter "name=overmind-postgres-pgvector" --format "{{.Names}}"',
351
+ { stdio: 'pipe' }
352
+ );
353
+
354
+ if (overmindContainer) {
355
+ log(COLORS.yellow, '⚠️ Container OverMind existe mais non démarré');
356
+ await runCommandAsync(
357
+ 'docker start overmind-postgres-pgvector',
358
+ 'Démarrage container OverMind existant'
359
+ );
360
+ return true;
361
+ }
362
+
363
+ log(COLORS.yellow, '🚀 Création et démarrage PostgreSQL + pgvector...');
346
364
 
347
365
  await runCommandAsync(
348
366
  'docker run -d --name overmind-postgres-pgvector -p 5432:5432 -e POSTGRES_PASSWORD=overmind_temp_password_change_me -e POSTGRES_USER=postgres -v overmind_postgres_data:/var/lib/postgresql/data --restart unless-stopped pgvector/pgvector:pg16',
349
- 'Démarrage PostgreSQL'
367
+ 'Création PostgreSQL OverMind'
350
368
  );
351
369
 
352
370
  log(COLORS.cyan, '\n⏳ Attente démarrage PostgreSQL (20s)...');