overmind-mcp 2.8.3 → 2.8.6

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.
Files changed (46) hide show
  1. package/.mcp.json.example +20 -20
  2. package/README.md +143 -143
  3. package/bin/overmind-pool.mjs +248 -248
  4. package/dist/bin/cli.js.map +1 -1
  5. package/dist/lib/config.d.ts +1 -0
  6. package/dist/lib/config.d.ts.map +1 -1
  7. package/dist/lib/config.js +2 -1
  8. package/dist/lib/config.js.map +1 -1
  9. package/dist/lib/orchestration/dispatcher.d.ts.map +1 -1
  10. package/dist/lib/orchestration/dispatcher.js +0 -1
  11. package/dist/lib/orchestration/dispatcher.js.map +1 -1
  12. package/dist/services/AntigravityRunner.d.ts +42 -0
  13. package/dist/services/AntigravityRunner.d.ts.map +1 -0
  14. package/dist/services/AntigravityRunner.js +404 -0
  15. package/dist/services/AntigravityRunner.js.map +1 -0
  16. package/dist/services/ClaudeRunner.d.ts.map +1 -1
  17. package/dist/services/ClaudeRunner.js.map +1 -1
  18. package/dist/services/GeminiRunner.d.ts +22 -0
  19. package/dist/services/GeminiRunner.d.ts.map +1 -1
  20. package/dist/services/GeminiRunner.js +115 -91
  21. package/dist/services/GeminiRunner.js.map +1 -1
  22. package/dist/services/KiloRunner.d.ts.map +1 -1
  23. package/dist/services/KiloRunner.js +6 -1
  24. package/dist/services/KiloRunner.js.map +1 -1
  25. package/dist/services/NousHermesRunner.d.ts +1 -0
  26. package/dist/services/NousHermesRunner.d.ts.map +1 -1
  27. package/dist/services/NousHermesRunner.js +366 -555
  28. package/dist/services/NousHermesRunner.js.map +1 -1
  29. package/dist/tools/config_example.d.ts +1 -0
  30. package/dist/tools/config_example.d.ts.map +1 -1
  31. package/dist/tools/config_example.js +45 -2
  32. package/dist/tools/config_example.js.map +1 -1
  33. package/dist/tools/manage_agents.d.ts +1 -1
  34. package/dist/tools/run_agent.d.ts +1 -0
  35. package/dist/tools/run_agent.d.ts.map +1 -1
  36. package/dist/tools/run_agent.js +27 -3
  37. package/dist/tools/run_agent.js.map +1 -1
  38. package/dist/tools/run_agents_parallel.d.ts +1 -0
  39. package/dist/tools/run_agents_parallel.d.ts.map +1 -1
  40. package/dist/tools/run_gemini.d.ts +13 -0
  41. package/dist/tools/run_gemini.d.ts.map +1 -1
  42. package/dist/tools/run_gemini.js +6 -2
  43. package/dist/tools/run_gemini.js.map +1 -1
  44. package/docs/agent-http-tutorial.md +524 -524
  45. package/docs/provider-config-map.md +379 -0
  46. package/package.json +1 -1
package/.mcp.json.example CHANGED
@@ -1,21 +1,21 @@
1
- {
2
- "mcpServers": {
3
- "memory-server": {
4
- "transport": "httpStream",
5
- "url": "http://localhost:3099/mcp",
6
- "description": "OverMind MCP - memory singleton sur port 3099"
7
- },
8
- "postgresql": {
9
- "transport": "httpStream",
10
- "url": "http://localhost:5433/mcp",
11
- "description": "PostgreSQL MCP - vector search sur port 5433"
12
- },
13
- "discord-server": {
14
- "transport": "httpStream",
15
- "url": "http://localhost:3141/mcp",
16
- "description": "Discord MCP - 88 outils sur port 3141"
17
- }
18
- },
19
- "description": "Configuration MCP HTTP Singleton - Anti-Zombie. Tous les serveurs doivent être démarrés.",
20
- "version": "2.4.0"
1
+ {
2
+ "mcpServers": {
3
+ "memory-server": {
4
+ "transport": "httpStream",
5
+ "url": "http://localhost:3099/mcp",
6
+ "description": "OverMind MCP - memory singleton sur port 3099"
7
+ },
8
+ "postgresql": {
9
+ "transport": "httpStream",
10
+ "url": "http://localhost:5433/mcp",
11
+ "description": "PostgreSQL MCP - vector search sur port 5433"
12
+ },
13
+ "discord-server": {
14
+ "transport": "httpStream",
15
+ "url": "http://localhost:3141/mcp",
16
+ "description": "Discord MCP - 88 outils sur port 3141"
17
+ }
18
+ },
19
+ "description": "Configuration MCP HTTP Singleton - Anti-Zombie. Tous les serveurs doivent être démarrés.",
20
+ "version": "2.4.0"
21
21
  }
package/README.md CHANGED
@@ -1,144 +1,144 @@
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.
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. Expert en outils MCP, il peut être scripté pour les faire fonctionner ensemble et les mettre en production.
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`.
25
- - 🛡️ **Mémoire Ségréguée** : Chaque agent peut posséder ses propres souvenirs isolés tout en ayant accès au socle global.
26
- - 🤖 **Multi-Agents** : Créez, configurez et gérez des personnalités d'agents isolées (Prompts & Settings dédiés).
27
- - 📦 **Prêt pour l'Intégration** : Importable comme un module NPM dans vos autres projets.
28
- - 🅾️ **HTTP Singleton** : Plus de zombies — 1 serveur HTTP partagé par tous les agents.
29
-
30
- ---
31
-
32
- ## 🚀 Installation
33
-
34
- ### Globale via NPM (Recommandé)
35
-
36
- ```bash
37
- npm install -g overmind-mcp@latest
38
- ```
39
-
40
- ### Configuration MCP (HTTP)
41
-
42
- Après installation, configurez votre client MCP avec le模式下 :
43
-
44
- ```json
45
- {
46
- "mcpServers": {
47
- "overmind": {
48
- "transport": "http-stream",
49
- "url": "http://localhost:3099"
50
- },
51
- "memory": {
52
- "transport": "http-stream",
53
- "url": "http://localhost:3099"
54
- },
55
- "postgresql": {
56
- "transport": "http-stream",
57
- "url": "http://localhost:5433",
58
- "description": "PostgreSQL MCP - Base de données vectorielle"
59
- }
60
- }
61
- }
62
- ```
63
-
64
- ---
65
-
66
- ## 🔧 Installation Locale (Dev)
67
-
68
- ```bash
69
- git clone https://github.com/DeamonDev888/overmind-mcp.git
70
- cd overmind-mcp
71
- pnpm install
72
- pnpm run build
73
- ```
74
-
75
- ---
76
-
77
- ### Utilisation comme Bibliothèque
78
-
79
- ```typescript
80
- import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
81
-
82
- // 1. Initialisation
83
- updateConfig('./settings.json', './mcp.local.json');
84
-
85
- // 2. Gestion des agents
86
- const manager = new AgentManager();
87
- await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
88
-
89
- // 3. Lancer une exécution
90
- const { content, isError } = await runAgent({
91
- runner: 'claude',
92
- agentName: 'expert-seo',
93
- prompt: 'Analyse le site example.com',
94
- autoResume: true,
95
- });
96
-
97
- if (!isError) {
98
- console.log('🤖 Résultat:', content[0].text);
99
- }
100
- ```
101
-
102
- ---
103
-
104
- ## 📂 Structure du Projet
105
-
106
- ```
107
- Workflow/
108
- ├── 📦 bin/ # Scripts d'installation
109
- ├── 🐳 docker/ # Configuration Docker
110
- ├── 🗄️ db/ # Scripts base de données
111
- ├── ⚙️ config/ # Configurations MCP
112
- ├── 📚 docs/ # Documentation
113
- ├── 💻 src/ # Code source
114
- │ ├── bin/ # Points d'entrée CLI
115
- │ ├── lib/ # Bibliothèques partagées
116
- │ ├── services/ # Services métier
117
- │ └── tools/ # Outils MCP
118
- ├── 🧪 tests/ # Tests unitaires
119
- └── 🔧 scripts/ # Scripts de maintenance
120
- ```
121
-
122
- ---
123
-
124
- ## 🛡️ Anti-Zombie Architecture
125
-
126
- L'ancien problème : chaque agent spawn son propre node.exe MCP server → zombies.
127
-
128
- La solution : 1 seul serveur HTTP par service, partagé par tous les agents.
129
-
130
- ```
131
- Agent 1 ──┐
132
- Agent 2 ──┼──→ Overmind:3099 (1 process)
133
- Agent 3 ──┘
134
- └──→ PostgreSQL:5433 (1 process)
135
- └──→ Discord:3141 (1 process)
136
- ```
137
-
138
- Plus de node.exe par agent = plus de zombies.
139
-
140
- ---
141
-
142
- ![Aperçu du Terminal](https://cdn.jsdelivr.net/npm/overmind-mcp@1.0.8/assets/terminal_preview.png)
143
-
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.
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. Expert en outils MCP, il peut être scripté pour les faire fonctionner ensemble et les mettre en production.
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`.
25
+ - 🛡️ **Mémoire Ségréguée** : Chaque agent peut posséder ses propres souvenirs isolés tout en ayant accès au socle global.
26
+ - 🤖 **Multi-Agents** : Créez, configurez et gérez des personnalités d'agents isolées (Prompts & Settings dédiés).
27
+ - 📦 **Prêt pour l'Intégration** : Importable comme un module NPM dans vos autres projets.
28
+ - 🅾️ **HTTP Singleton** : Plus de zombies — 1 serveur HTTP partagé par tous les agents.
29
+
30
+ ---
31
+
32
+ ## 🚀 Installation
33
+
34
+ ### Globale via NPM (Recommandé)
35
+
36
+ ```bash
37
+ npm install -g overmind-mcp@latest
38
+ ```
39
+
40
+ ### Configuration MCP (HTTP)
41
+
42
+ Après installation, configurez votre client MCP avec le模式下 :
43
+
44
+ ```json
45
+ {
46
+ "mcpServers": {
47
+ "overmind": {
48
+ "transport": "http-stream",
49
+ "url": "http://localhost:3099"
50
+ },
51
+ "memory": {
52
+ "transport": "http-stream",
53
+ "url": "http://localhost:3099"
54
+ },
55
+ "postgresql": {
56
+ "transport": "http-stream",
57
+ "url": "http://localhost:5433",
58
+ "description": "PostgreSQL MCP - Base de données vectorielle"
59
+ }
60
+ }
61
+ }
62
+ ```
63
+
64
+ ---
65
+
66
+ ## 🔧 Installation Locale (Dev)
67
+
68
+ ```bash
69
+ git clone https://github.com/DeamonDev888/overmind-mcp.git
70
+ cd overmind-mcp
71
+ pnpm install
72
+ pnpm run build
73
+ ```
74
+
75
+ ---
76
+
77
+ ### Utilisation comme Bibliothèque
78
+
79
+ ```typescript
80
+ import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
81
+
82
+ // 1. Initialisation
83
+ updateConfig('./settings.json', './mcp.local.json');
84
+
85
+ // 2. Gestion des agents
86
+ const manager = new AgentManager();
87
+ await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
88
+
89
+ // 3. Lancer une exécution
90
+ const { content, isError } = await runAgent({
91
+ runner: 'claude',
92
+ agentName: 'expert-seo',
93
+ prompt: 'Analyse le site example.com',
94
+ autoResume: true,
95
+ });
96
+
97
+ if (!isError) {
98
+ console.log('🤖 Résultat:', content[0].text);
99
+ }
100
+ ```
101
+
102
+ ---
103
+
104
+ ## 📂 Structure du Projet
105
+
106
+ ```
107
+ Workflow/
108
+ ├── 📦 bin/ # Scripts d'installation
109
+ ├── 🐳 docker/ # Configuration Docker
110
+ ├── 🗄️ db/ # Scripts base de données
111
+ ├── ⚙️ config/ # Configurations MCP
112
+ ├── 📚 docs/ # Documentation
113
+ ├── 💻 src/ # Code source
114
+ │ ├── bin/ # Points d'entrée CLI
115
+ │ ├── lib/ # Bibliothèques partagées
116
+ │ ├── services/ # Services métier
117
+ │ └── tools/ # Outils MCP
118
+ ├── 🧪 tests/ # Tests unitaires
119
+ └── 🔧 scripts/ # Scripts de maintenance
120
+ ```
121
+
122
+ ---
123
+
124
+ ## 🛡️ Anti-Zombie Architecture
125
+
126
+ L'ancien problème : chaque agent spawn son propre node.exe MCP server → zombies.
127
+
128
+ La solution : 1 seul serveur HTTP par service, partagé par tous les agents.
129
+
130
+ ```
131
+ Agent 1 ──┐
132
+ Agent 2 ──┼──→ Overmind:3099 (1 process)
133
+ Agent 3 ──┘
134
+ └──→ PostgreSQL:5433 (1 process)
135
+ └──→ Discord:3141 (1 process)
136
+ ```
137
+
138
+ Plus de node.exe par agent = plus de zombies.
139
+
140
+ ---
141
+
142
+ ![Aperçu du Terminal](https://cdn.jsdelivr.net/npm/overmind-mcp@1.0.8/assets/terminal_preview.png)
143
+
144
144
  _Projet propulsé par DeaMoN888 - 2026_