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.
- package/.mcp.json.example +20 -20
- package/README.md +143 -143
- package/bin/overmind-pool.mjs +248 -248
- package/dist/bin/cli.js.map +1 -1
- package/dist/lib/config.d.ts +1 -0
- package/dist/lib/config.d.ts.map +1 -1
- package/dist/lib/config.js +2 -1
- package/dist/lib/config.js.map +1 -1
- package/dist/lib/orchestration/dispatcher.d.ts.map +1 -1
- package/dist/lib/orchestration/dispatcher.js +0 -1
- package/dist/lib/orchestration/dispatcher.js.map +1 -1
- package/dist/services/AntigravityRunner.d.ts +42 -0
- package/dist/services/AntigravityRunner.d.ts.map +1 -0
- package/dist/services/AntigravityRunner.js +404 -0
- package/dist/services/AntigravityRunner.js.map +1 -0
- package/dist/services/ClaudeRunner.d.ts.map +1 -1
- package/dist/services/ClaudeRunner.js.map +1 -1
- package/dist/services/GeminiRunner.d.ts +22 -0
- package/dist/services/GeminiRunner.d.ts.map +1 -1
- package/dist/services/GeminiRunner.js +115 -91
- package/dist/services/GeminiRunner.js.map +1 -1
- package/dist/services/KiloRunner.d.ts.map +1 -1
- package/dist/services/KiloRunner.js +6 -1
- package/dist/services/KiloRunner.js.map +1 -1
- package/dist/services/NousHermesRunner.d.ts +1 -0
- package/dist/services/NousHermesRunner.d.ts.map +1 -1
- package/dist/services/NousHermesRunner.js +366 -555
- package/dist/services/NousHermesRunner.js.map +1 -1
- package/dist/tools/config_example.d.ts +1 -0
- package/dist/tools/config_example.d.ts.map +1 -1
- package/dist/tools/config_example.js +45 -2
- package/dist/tools/config_example.js.map +1 -1
- package/dist/tools/manage_agents.d.ts +1 -1
- package/dist/tools/run_agent.d.ts +1 -0
- package/dist/tools/run_agent.d.ts.map +1 -1
- package/dist/tools/run_agent.js +27 -3
- package/dist/tools/run_agent.js.map +1 -1
- package/dist/tools/run_agents_parallel.d.ts +1 -0
- package/dist/tools/run_agents_parallel.d.ts.map +1 -1
- package/dist/tools/run_gemini.d.ts +13 -0
- package/dist/tools/run_gemini.d.ts.map +1 -1
- package/dist/tools/run_gemini.js +6 -2
- package/dist/tools/run_gemini.js.map +1 -1
- package/docs/agent-http-tutorial.md +524 -524
- package/docs/provider-config-map.md +379 -0
- 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
|
-

|
|
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
|
+

|
|
143
|
+
|
|
144
144
|
_Projet propulsé par DeaMoN888 - 2026_
|