overmind-mcp 2.2.2 → 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 +31 -141
- package/package.json +1 -1
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
|
-
## 🚀
|
|
33
|
+
## 🚀 Installation
|
|
34
34
|
|
|
35
|
-
###
|
|
35
|
+
### Globale via NPM (Recommandé)
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
38
|
npm install -g overmind-mcp@latest
|
|
39
39
|
```
|
|
40
40
|
|
|
41
|
-
**🎯
|
|
41
|
+
**🎯 Ce qui est installé automatiquement :**
|
|
42
42
|
|
|
43
|
-
|
|
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
|
-
|
|
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
|
-
|
|
55
|
+
### Configuration MCP
|
|
48
56
|
|
|
49
|
-
|
|
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
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
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
|
-
|
|
72
|
+
## 🔧 Installation Locale (Dev)
|
|
73
|
+
|
|
74
|
+
Si vous souhaitez contribuer au projet :
|
|
165
75
|
|
|
166
76
|
```bash
|
|
167
|
-
#
|
|
168
|
-
git clone https://github.com/DeamonDev888/overmind-mcp
|
|
77
|
+
# Cloner le repo
|
|
78
|
+
git clone https://github.com/DeamonDev888/overmind-mcp.git
|
|
169
79
|
cd overmind-mcp
|
|
170
80
|
|
|
171
|
-
#
|
|
81
|
+
# Installer les dépendances
|
|
172
82
|
pnpm install
|
|
173
83
|
|
|
174
|
-
#
|
|
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
|
-
|
|
90
|
+
### Utilisation comme Bibliothèque
|
|
201
91
|
|
|
202
|
-
Vous pouvez
|
|
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
|
|
102
|
+
await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
|
|
213
103
|
|
|
214
|
-
// 3. Lancer une exécution
|
|
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.
|
|
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",
|