overmind-mcp 2.3.2 → 2.3.4

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/.mcp.json.example CHANGED
@@ -1,21 +1,21 @@
1
- {
2
- "mcpServers": {
3
- "overmind": {
4
- "command": "overmind",
5
- "description": "OverMind-MCP principal - Orchestration d'agents IA"
6
- },
7
- "memory": {
8
- "command": "overmind",
9
- "args": ["--memory-only"],
10
- "description": "OverMind-MCP mémoire - Gestion mémoire vectorielle"
11
- },
12
- "overmind-postgres": {
13
- "command": "overmind-postgres-mcp",
14
- "description": "OverMind-PostgreSQL-MCP - Serveur PostgreSQL vectoriel optimisé pour OverMind"
15
- }
16
- },
17
- "description": "Configuration MCP OverMind-MCP optimisée pour installation globale npm",
18
- "version": "2.2.6",
19
- "installation": "npm install -g overmind-mcp",
20
- "note": "Après installation globale, les commandes 'overmind' et 'overmind-postgres-mcp' sont disponibles directement dans le système. Cette configuration utilise les binaires globaux installés par npm."
21
- }
1
+ {
2
+ "mcpServers": {
3
+ "overmind": {
4
+ "command": "overmind",
5
+ "description": "OverMind-MCP principal - Orchestration d'agents IA"
6
+ },
7
+ "memory": {
8
+ "command": "overmind",
9
+ "args": ["--memory-only"],
10
+ "description": "OverMind-MCP mémoire - Gestion mémoire vectorielle"
11
+ },
12
+ "overmind-postgres": {
13
+ "command": "overmind-postgres-mcp",
14
+ "description": "OverMind-PostgreSQL-MCP - Serveur PostgreSQL vectoriel optimisé pour OverMind"
15
+ }
16
+ },
17
+ "description": "Configuration MCP OverMind-MCP optimisée pour installation globale npm",
18
+ "version": "2.2.6",
19
+ "installation": "npm install -g overmind-mcp",
20
+ "note": "Après installation globale, les commandes 'overmind' et 'overmind-postgres-mcp' sont disponibles directement dans le système. Cette configuration utilise les binaires globaux installés par npm."
21
+ }
package/README.md CHANGED
@@ -1,187 +1,187 @@
1
- <p align="center">
2
- <img src="assets/overmind.png" alt="OverMind-MCP Banner" width="293" height="253">
3
- </p>
4
-
5
- <div align="center">
6
-
7
- # 🧠 OverMind-MCP
8
-
9
- </div>
10
-
11
- _Orchestrateur universel agents IA multi-modeles via MCP pour piloter Claude-Code, Gemini-cli, QwenCli, Nous Hermes, Kilo/Cline, OpenClaw, GLM, Minimax, Kimi, Ollama et plus sans limite._
12
-
13
- <p align="center">
14
- <a href="https://discord.gg/4AR82phtBz"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
15
- <a href="https://deamondev888.github.io/overmind-mcp/"><img src="https://img.shields.io/badge/Documentation-Live-00fff5?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Live Doc"></a>
16
- </p>
17
-
18
- **OverMind-MCP** est une conscience supérieure conçue pour orchestrer, commander et automatiser une flotte illimitée d'agents IA. Compatible avec **Claude-Code, Gemini-cli, QwenCli, Nous Hermes, Kilo/Cline, OpenClaw**, et prêt pour **GLM, Minimax, Kimi, Ollama** et bien d'autres. Plus qu'un simple runner, c'est le **Cortex Central** de votre infrastructure IA.
19
-
20
- Il transforme les outils CLI isolés en une force coordonnée, pilotable par API ou par MCP, capable d'exécuter des missions complexes en 2 secondes chrono. de creer et d orchestrer des pipeline de plusieurs agent. il est expert en outils MCP et peu etre scripté pour les faire fonctionner ensemble et les mettre en productions
21
-
22
- - 🔌 **Contrôle Total** : Lancez des missions complexes via MCP ou directement via le code (Claude, Gemini, QwenCli, Hermes).
23
- - 🏗️ **Architecture Pro** : Basé sur des services (`AgentManager`, `ClaudeRunner`, `PromptManager`) pour une stabilité maximale.
24
- - 🧠 **Mémoire Haute-Performance (4096D)** : Système RAG intégré via PostgreSQL + `pgvector` supportant les embeddings SOTA (Qwen 8B).
25
- - 🕵️ **Auto-Diagnostic CLI** : Détecte automatiquement les runners manquants et fournit les instructions/liens officiels pour l'installation.
26
- - 🛡️ **Mémoire Ségréguée** : Chaque agent peut posséder ses propres souvenirs isolés tout en ayant accès au socle de connaissances global.
27
- - 🛠️ **Capacités Étendues** : L'agent piloté peut utiliser VOS outils (Base de données, Scrapers, etc.).
28
- - 🤖 **Multi-Agents** : Créez, configurez et gérez des personnalités d'agents isolées (Prompts & Settings dédiés).
29
- - 📦 **Prêt pour l'Intégration** : Importable comme un module NPM dans vos autres projets.
30
-
31
- ---
32
-
33
- ## 🚀 Installation
34
-
35
- ### Globale via NPM (Recommandé)
36
-
37
- ```bash
38
- npm install -g overmind-mcp@latest
39
- ```
40
-
41
- **🎯 Ce qui est installé automatiquement :**
42
-
43
- 1. **Détection Docker** - Compatible avec Docker Desktop, Podman, Rancher Desktop, Colima, OrbStack
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
48
-
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
54
-
55
- ### Configuration MCP
56
-
57
- Pour utiliser OverMind dans votre IDE ou CLI préféré :
58
-
59
- ```json
60
- {
61
- "mcpServers": {
62
- "overmind": {
63
- "command": "npx",
64
- "args": ["-y", "overmind-mcp@latest"]
65
- }
66
- }
67
- }
68
- ```
69
-
70
- ---
71
-
72
- ## 🔧 Installation Locale (Dev)
73
-
74
- Si vous souhaitez contribuer au projet :
75
-
76
- ```bash
77
- # Cloner le repo
78
- git clone https://github.com/DeamonDev888/overmind-mcp.git
79
- cd overmind-mcp
80
-
81
- # Installer les dépendances
82
- pnpm install
83
-
84
- # Builder le projet
85
- pnpm run build
86
- ```
87
-
88
- ---
89
-
90
- ### Utilisation comme Bibliothèque
91
-
92
- Vous pouvez utiliser OverMind-MCP comme un module dans vos propres projets TypeScript/JavaScript :
93
-
94
- ```typescript
95
- import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
96
-
97
- // 1. Initialisation
98
- updateConfig('./settings.json', './mcp.local.json');
99
-
100
- // 2. Gestion des agents
101
- const manager = new AgentManager();
102
- await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
103
-
104
- // 3. Lancer une exécution
105
- const { content, isError } = await runAgent({
106
- runner: 'claude',
107
- agentName: 'expert-seo',
108
- prompt: 'Analyse le site example.com',
109
- autoResume: true,
110
- });
111
-
112
- if (!isError) {
113
- console.log('🤖 Résultat:', content[0].text);
114
- }
115
- ```
116
-
117
- ---
118
-
119
- ## 📂 Structure du Projet
120
-
121
- OverMind-MCP est organisé de manière modulaire pour faciliter la navigation et la maintenance.
122
-
123
- ```
124
- Workflow/
125
- ├── 📦 bin/ # Scripts d'installation
126
- ├── 📋 changelog/ # Historique des versions
127
- ├── 🐳 docker/ # Configuration Docker
128
- ├── 🗄️ db/ # Scripts base de données
129
- ├── ⚙️ config/ # Configurations MCP
130
- ├── 📚 docs/ # Documentation complète
131
- ├── 💻 src/ # Code source
132
- │ ├── bin/ # Points d'entrée CLI
133
- │ ├── lib/ # Bibliothèques partagées
134
- │ ├── services/ # Services métier
135
- │ └── tools/ # Outils MCP
136
- ├── 🧪 tests/ # Tests unitaires
137
- └── 🔧 scripts/ # Scripts de maintenance
138
- ```
139
-
140
- **📖 Documentation détaillée** : Voir [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) pour une explication complète de chaque dossier.
141
-
142
- **Points clés :**
143
- - `src/services/` : Le cœur du système (Logique métier isolée en services)
144
- - `src/tools/` : Les outils MCP qui appellent les services
145
- - `src/bin/cli.ts` : Le point d'entrée exécutable pour le terminal
146
- - `src/server.ts` : La définition du serveur FastMCP
147
- - `.claude/` : Stockage des agents (Prompts `.md` et Settings `.json`)
148
-
149
- ---
150
-
151
- ## ⚙️ Configuration MCP (après installation globale)
152
-
153
- Après `npm install -g overmind-mcp`, voici la configuration MCP recommandée pour votre client (Claude Code, Cline, etc.) :
154
-
155
- ```json
156
- {
157
- "mcpServers": {
158
- "overmind": {
159
- "command": "overmind",
160
- "description": "OverMind-MCP principal - Orchestration d'agents IA"
161
- },
162
- "memory": {
163
- "command": "overmind",
164
- "args": ["--memory-only"],
165
- "description": "OverMind-MCP mémoire - Gestion mémoire vectorielle"
166
- },
167
- "overmind-postgres": {
168
- "command": "overmind-postgres-mcp",
169
- "description": "OverMind-PostgreSQL-MCP - Serveur PostgreSQL vectoriel optimisé pour OverMind"
170
- }
171
- },
172
- "description": "Configuration MCP OverMind-MCP optimisée pour installation globale npm",
173
- "version": "2.2.6",
174
- "installation": "npm install -g overmind-mcp",
175
- "note": "Après installation globale, les commandes 'overmind' et 'overmind-postgres-mcp' sont disponibles directement dans le système. Cette configuration utilise les binaires globaux installés par npm."
176
- }
177
- ```
178
-
179
- **📖 Exemples de configuration détaillée** : Voir `config/README.md` pour plus de scénarios d'utilisation.
180
-
181
- ---
182
-
183
- ![Aperçu du Terminal](https://cdn.jsdelivr.net/npm/overmind-mcp@1.0.8/assets/terminal_preview.png)
184
-
185
- _Note : L'**OverMind** punit et martyrise les **OpenClaw** qui n'écoutent pas._ 😈
186
-
187
- _Projet propulsé par DeaMoN888 - 2026_
1
+ <p align="center">
2
+ <img src="assets/overmind.png" alt="OverMind-MCP Banner" width="293" height="253">
3
+ </p>
4
+
5
+ <div align="center">
6
+
7
+ # 🧠 OverMind-MCP
8
+
9
+ </div>
10
+
11
+ _Orchestrateur universel agents IA multi-modeles via MCP pour piloter Claude-Code, Gemini-cli, QwenCli, Nous Hermes, Kilo/Cline, OpenClaw, GLM, Minimax, Kimi, Ollama et plus sans limite._
12
+
13
+ <p align="center">
14
+ <a href="https://discord.gg/4AR82phtBz"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
15
+ <a href="https://deamondev888.github.io/overmind-mcp/"><img src="https://img.shields.io/badge/Documentation-Live-00fff5?style=for-the-badge&logo=google-chrome&logoColor=white" alt="Live Doc"></a>
16
+ </p>
17
+
18
+ **OverMind-MCP** est une conscience supérieure conçue pour orchestrer, commander et automatiser une flotte illimitée d'agents IA. Compatible avec **Claude-Code, Gemini-cli, QwenCli, Nous Hermes, Kilo/Cline, OpenClaw**, et prêt pour **GLM, Minimax, Kimi, Ollama** et bien d'autres. Plus qu'un simple runner, c'est le **Cortex Central** de votre infrastructure IA.
19
+
20
+ Il transforme les outils CLI isolés en une force coordonnée, pilotable par API ou par MCP, capable d'exécuter des missions complexes en 2 secondes chrono. de creer et d orchestrer des pipeline de plusieurs agent. il est expert en outils MCP et peu etre scripté pour les faire fonctionner ensemble et les mettre en productions
21
+
22
+ - 🔌 **Contrôle Total** : Lancez des missions complexes via MCP ou directement via le code (Claude, Gemini, QwenCli, Hermes).
23
+ - 🏗️ **Architecture Pro** : Basé sur des services (`AgentManager`, `ClaudeRunner`, `PromptManager`) pour une stabilité maximale.
24
+ - 🧠 **Mémoire Haute-Performance (4096D)** : Système RAG intégré via PostgreSQL + `pgvector` supportant les embeddings SOTA (Qwen 8B).
25
+ - 🕵️ **Auto-Diagnostic CLI** : Détecte automatiquement les runners manquants et fournit les instructions/liens officiels pour l'installation.
26
+ - 🛡️ **Mémoire Ségréguée** : Chaque agent peut posséder ses propres souvenirs isolés tout en ayant accès au socle de connaissances global.
27
+ - 🛠️ **Capacités Étendues** : L'agent piloté peut utiliser VOS outils (Base de données, Scrapers, etc.).
28
+ - 🤖 **Multi-Agents** : Créez, configurez et gérez des personnalités d'agents isolées (Prompts & Settings dédiés).
29
+ - 📦 **Prêt pour l'Intégration** : Importable comme un module NPM dans vos autres projets.
30
+
31
+ ---
32
+
33
+ ## 🚀 Installation
34
+
35
+ ### Globale via NPM (Recommandé)
36
+
37
+ ```bash
38
+ npm install -g overmind-mcp@latest
39
+ ```
40
+
41
+ **🎯 Ce qui est installé automatiquement :**
42
+
43
+ 1. **Détection Docker** - Compatible avec Docker Desktop, Podman, Rancher Desktop, Colima, OrbStack
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
48
+
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
54
+
55
+ ### Configuration MCP
56
+
57
+ Pour utiliser OverMind dans votre IDE ou CLI préféré :
58
+
59
+ ```json
60
+ {
61
+ "mcpServers": {
62
+ "overmind": {
63
+ "command": "npx",
64
+ "args": ["-y", "overmind-mcp@latest"]
65
+ }
66
+ }
67
+ }
68
+ ```
69
+
70
+ ---
71
+
72
+ ## 🔧 Installation Locale (Dev)
73
+
74
+ Si vous souhaitez contribuer au projet :
75
+
76
+ ```bash
77
+ # Cloner le repo
78
+ git clone https://github.com/DeamonDev888/overmind-mcp.git
79
+ cd overmind-mcp
80
+
81
+ # Installer les dépendances
82
+ pnpm install
83
+
84
+ # Builder le projet
85
+ pnpm run build
86
+ ```
87
+
88
+ ---
89
+
90
+ ### Utilisation comme Bibliothèque
91
+
92
+ Vous pouvez utiliser OverMind-MCP comme un module dans vos propres projets TypeScript/JavaScript :
93
+
94
+ ```typescript
95
+ import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
96
+
97
+ // 1. Initialisation
98
+ updateConfig('./settings.json', './mcp.local.json');
99
+
100
+ // 2. Gestion des agents
101
+ const manager = new AgentManager();
102
+ await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
103
+
104
+ // 3. Lancer une exécution
105
+ const { content, isError } = await runAgent({
106
+ runner: 'claude',
107
+ agentName: 'expert-seo',
108
+ prompt: 'Analyse le site example.com',
109
+ autoResume: true,
110
+ });
111
+
112
+ if (!isError) {
113
+ console.log('🤖 Résultat:', content[0].text);
114
+ }
115
+ ```
116
+
117
+ ---
118
+
119
+ ## 📂 Structure du Projet
120
+
121
+ OverMind-MCP est organisé de manière modulaire pour faciliter la navigation et la maintenance.
122
+
123
+ ```
124
+ Workflow/
125
+ ├── 📦 bin/ # Scripts d'installation
126
+ ├── 📋 changelog/ # Historique des versions
127
+ ├── 🐳 docker/ # Configuration Docker
128
+ ├── 🗄️ db/ # Scripts base de données
129
+ ├── ⚙️ config/ # Configurations MCP
130
+ ├── 📚 docs/ # Documentation complète
131
+ ├── 💻 src/ # Code source
132
+ │ ├── bin/ # Points d'entrée CLI
133
+ │ ├── lib/ # Bibliothèques partagées
134
+ │ ├── services/ # Services métier
135
+ │ └── tools/ # Outils MCP
136
+ ├── 🧪 tests/ # Tests unitaires
137
+ └── 🔧 scripts/ # Scripts de maintenance
138
+ ```
139
+
140
+ **📖 Documentation détaillée** : Voir [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) pour une explication complète de chaque dossier.
141
+
142
+ **Points clés :**
143
+ - `src/services/` : Le cœur du système (Logique métier isolée en services)
144
+ - `src/tools/` : Les outils MCP qui appellent les services
145
+ - `src/bin/cli.ts` : Le point d'entrée exécutable pour le terminal
146
+ - `src/server.ts` : La définition du serveur FastMCP
147
+ - `.claude/` : Stockage des agents (Prompts `.md` et Settings `.json`)
148
+
149
+ ---
150
+
151
+ ## ⚙️ Configuration MCP (après installation globale)
152
+
153
+ Après `npm install -g overmind-mcp`, voici la configuration MCP recommandée pour votre client (Claude Code, Cline, etc.) :
154
+
155
+ ```json
156
+ {
157
+ "mcpServers": {
158
+ "overmind": {
159
+ "command": "overmind",
160
+ "description": "OverMind-MCP principal - Orchestration d'agents IA"
161
+ },
162
+ "memory": {
163
+ "command": "overmind",
164
+ "args": ["--memory-only"],
165
+ "description": "OverMind-MCP mémoire - Gestion mémoire vectorielle"
166
+ },
167
+ "overmind-postgres": {
168
+ "command": "overmind-postgres-mcp",
169
+ "description": "OverMind-PostgreSQL-MCP - Serveur PostgreSQL vectoriel optimisé pour OverMind"
170
+ }
171
+ },
172
+ "description": "Configuration MCP OverMind-MCP optimisée pour installation globale npm",
173
+ "version": "2.2.6",
174
+ "installation": "npm install -g overmind-mcp",
175
+ "note": "Après installation globale, les commandes 'overmind' et 'overmind-postgres-mcp' sont disponibles directement dans le système. Cette configuration utilise les binaires globaux installés par npm."
176
+ }
177
+ ```
178
+
179
+ **📖 Exemples de configuration détaillée** : Voir `config/README.md` pour plus de scénarios d'utilisation.
180
+
181
+ ---
182
+
183
+ ![Aperçu du Terminal](https://cdn.jsdelivr.net/npm/overmind-mcp@1.0.8/assets/terminal_preview.png)
184
+
185
+ _Note : L'**OverMind** punit et martyrise les **OpenClaw** qui n'écoutent pas._ 😈
186
+
187
+ _Projet propulsé par DeaMoN888 - 2026_
package/bin/README.md CHANGED
@@ -1,34 +1,34 @@
1
- # 📦 Installation Scripts
2
-
3
- Ce dossier contient les scripts d'installation d'OverMind MCP.
4
-
5
- ## 📜 Fichiers
6
-
7
- - **install-overmind-unix.sh** - Script d'installation pour Linux/macOS
8
- - **install-overmind-windows.bat** - Script d'installation pour Windows
9
-
10
- ## 🚀 Utilisation
11
-
12
- ### Windows
13
- ```batch
14
- cd bin
15
- install-overmind-windows.bat
16
- ```
17
-
18
- ### Linux/macOS
19
- ```bash
20
- cd bin
21
- chmod +x install-overmind-unix.sh
22
- ./install-overmind-unix.sh
23
- ```
24
-
25
- ## 📋 Ce qui est installé
26
-
27
- - OverMind MCP (NPM package)
28
- - PostgreSQL + pgvector (Docker)
29
- - RabbitMQ (Docker)
30
- - Temporal (Docker)
31
- - Prometheus (Docker)
32
- - Grafana (Docker)
33
- - Jaeger (Docker)
34
- - Redis (Docker)
1
+ # 📦 Installation Scripts
2
+
3
+ Ce dossier contient les scripts d'installation d'OverMind MCP.
4
+
5
+ ## 📜 Fichiers
6
+
7
+ - **install-overmind-unix.sh** - Script d'installation pour Linux/macOS
8
+ - **install-overmind-windows.bat** - Script d'installation pour Windows
9
+
10
+ ## 🚀 Utilisation
11
+
12
+ ### Windows
13
+ ```batch
14
+ cd bin
15
+ install-overmind-windows.bat
16
+ ```
17
+
18
+ ### Linux/macOS
19
+ ```bash
20
+ cd bin
21
+ chmod +x install-overmind-unix.sh
22
+ ./install-overmind-unix.sh
23
+ ```
24
+
25
+ ## 📋 Ce qui est installé
26
+
27
+ - OverMind MCP (NPM package)
28
+ - PostgreSQL + pgvector (Docker)
29
+ - RabbitMQ (Docker)
30
+ - Temporal (Docker)
31
+ - Prometheus (Docker)
32
+ - Grafana (Docker)
33
+ - Jaeger (Docker)
34
+ - Redis (Docker)