overmind-mcp 2.7.0 → 2.8.1

package/.mcp.json.example

@@ -1,21 +1,21 @@
-{
-  "mcpServers": {
-    "overmind": {
-      "command": "overmind",
-      "description": "OverMind-MCP principal - Orchestration d'agents IA"
-    },
-    "memory": {
-      "command": "overmind",
-      "args": ["--memory-only"],
-      "description": "OverMind-MCP mémoire - Gestion mémoire vectorielle"
-    },
-    "overmind-postgres": {
-      "command": "overmind-postgres-mcp",
-      "description": "OverMind-PostgreSQL-MCP - Serveur PostgreSQL vectoriel optimisé pour OverMind"
-    }
-  },
-  "description": "Configuration MCP OverMind-MCP optimisée pour installation globale npm",
-  "version": "2.2.6",
-  "installation": "npm install -g overmind-mcp",
-  "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."
-}
+{
+  "mcpServers": {
+    "memory-server": {
+      "transport": "httpStream",
+      "url": "http://localhost:3099/mcp",
+      "description": "OverMind MCP - memory singleton sur port 3099"
+    },
+    "postgresql": {
+      "transport": "httpStream",
+      "url": "http://localhost:5433/mcp",
+      "description": "PostgreSQL MCP - vector search sur port 5433"
+    },
+    "discord-server": {
+      "transport": "httpStream",
+      "url": "http://localhost:3141/mcp",
+      "description": "Discord MCP - 88 outils sur port 3141"
+    } 
+  },
+  "description": "Configuration MCP HTTP Singleton - Anti-Zombie. Tous les serveurs doivent être démarrés.",
+  "version": "2.4.0"
+}

package/README.md

@@ -1,187 +1,179 @@
-<p align="center">
-  <img src="assets/overmind.png" alt="OverMind-MCP Banner" width="293" height="253">
-</p>
-
-<div align="center">
-
-# 🧠 OverMind-MCP
-
-</div>
-
-_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._
-
-<p align="center">
-  <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>
-  <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>
-</p>
-
-**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.
-
-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
-
-- 🔌 **Contrôle Total** : Lancez des missions complexes via MCP ou directement via le code (Claude, Gemini, QwenCli, Hermes).
-- 🏗️ **Architecture Pro** : Basé sur des services (`AgentManager`, `ClaudeRunner`, `PromptManager`) pour une stabilité maximale.
-- 🧠 **Mémoire Haute-Performance (4096D)** : Système RAG intégré via PostgreSQL + `pgvector` supportant les embeddings SOTA (Qwen 8B).
-- 🕵️ **Auto-Diagnostic CLI** : Détecte automatiquement les runners manquants et fournit les instructions/liens officiels pour l'installation.
-- 🛡️ **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.
-- 🛠️ **Capacités Étendues** : L'agent piloté peut utiliser VOS outils (Base de données, Scrapers, etc.).
-- 🤖 **Multi-Agents** : Créez, configurez et gérez des personnalités d'agents isolées (Prompts & Settings dédiés).
-- 📦 **Prêt pour l'Intégration** : Importable comme un module NPM dans vos autres projets.
-
----
-
-## 🚀 Installation
-
-### Globale via NPM (Recommandé)
-
-```bash
-npm install -g overmind-mcp@latest
-```
-
-**🎯 Ce qui est installé automatiquement :**
-
-1. **Détection Docker** - Compatible avec Docker Desktop, Podman, Rancher Desktop, Colima, OrbStack
-2. **PostgreSQL + pgvector** - Container Docker avec extension vectorielle (si absent)
-3. **overmind-postgres-mcp** - Serveur MCP PostgreSQL vectoriel installé automatiquement
-4. **Configuration complète** - Fichiers .env et .mcp.json générés automatiquement
-5. **Base de données initialisée** - Tables OverMind créées automatiquement
-
-**✅ Installation ultra-simplifiée :**
-- 📦 **Taille** : 1-5 GB (au lieu de 8 GB)
-- ⚡ **Rapide** : ~15 secondes chrono
-- 🎯 **Automatique** : Tout configuré pour vous
-- 🛡️ **Sécurisé** - Vos containers personnels sont protégés
-
-### Configuration MCP
-
-Pour utiliser OverMind dans votre IDE ou CLI préféré :
-
-```json
-{
-  "mcpServers": {
-    "overmind": {
-      "command": "npx",
-      "args": ["-y", "overmind-mcp@latest"]
-    }
-  }
-}
-```
-
----
-
-## 🔧 Installation Locale (Dev)
-
-Si vous souhaitez contribuer au projet :
-
-```bash
-# Cloner le repo
-git clone https://github.com/DeamonDev888/overmind-mcp.git
-cd overmind-mcp
-
-# Installer les dépendances
-pnpm install
-
-# Builder le projet
-pnpm run build
-```
-
----
-
-### Utilisation comme Bibliothèque
-
-Vous pouvez utiliser OverMind-MCP comme un module dans vos propres projets TypeScript/JavaScript :
-
-```typescript
-import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
-
-// 1. Initialisation
-updateConfig('./settings.json', './mcp.local.json');
-
-// 2. Gestion des agents
-const manager = new AgentManager();
-await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
-
-// 3. Lancer une exécution
-const { content, isError } = await runAgent({
-  runner: 'claude',
-  agentName: 'expert-seo',
-  prompt: 'Analyse le site example.com',
-  autoResume: true,
-});
-
-if (!isError) {
-  console.log('🤖 Résultat:', content[0].text);
-}
-```
-
----
-
-## 📂 Structure du Projet
-
-OverMind-MCP est organisé de manière modulaire pour faciliter la navigation et la maintenance.
-
-```
-Workflow/
-├── 📦 bin/                    # Scripts d'installation
-├── 📋 changelog/             # Historique des versions
-├── 🐳 docker/                # Configuration Docker
-├── 🗄️ db/                    # Scripts base de données
-├── ⚙️ config/               # Configurations MCP
-├── 📚 docs/                  # Documentation complète
-├── 💻 src/                   # Code source
-│   ├── bin/                  # Points d'entrée CLI
-│   ├── lib/                  # Bibliothèques partagées
-│   ├── services/             # Services métier
-│   └── tools/                # Outils MCP
-├── 🧪 tests/                 # Tests unitaires
-└── 🔧 scripts/              # Scripts de maintenance
-```
-
-**📖 Documentation détaillée** : Voir [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md) pour une explication complète de chaque dossier.
-
-**Points clés :**
-- `src/services/` : Le cœur du système (Logique métier isolée en services)
-- `src/tools/` : Les outils MCP qui appellent les services
-- `src/bin/cli.ts` : Le point d'entrée exécutable pour le terminal
-- `src/server.ts` : La définition du serveur FastMCP
-- `.claude/` : Stockage des agents (Prompts `.md` et Settings `.json`)
-
----
-
-## ⚙️ Configuration MCP (après installation globale)
-
-Après `npm install -g overmind-mcp`, voici la configuration MCP recommandée pour votre client (Claude Code, Cline, etc.) :
-
-```json
-{
-  "mcpServers": {
-    "overmind": {
-      "command": "overmind",
-      "description": "OverMind-MCP principal - Orchestration d'agents IA"
-    },
-    "memory": {
-      "command": "overmind",
-      "args": ["--memory-only"],
-      "description": "OverMind-MCP mémoire - Gestion mémoire vectorielle"
-    },
-    "overmind-postgres": {
-      "command": "overmind-postgres-mcp",
-      "description": "OverMind-PostgreSQL-MCP - Serveur PostgreSQL vectoriel optimisé pour OverMind"
-    }
-  },
-  "description": "Configuration MCP OverMind-MCP optimisée pour installation globale npm",
-  "version": "2.2.6",
-  "installation": "npm install -g overmind-mcp",
-  "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."
-}
-```
-
-**📖 Exemples de configuration détaillée** : Voir `config/README.md` pour plus de scénarios d'utilisation.
-
----
-
-![Aperçu du Terminal](https://cdn.jsdelivr.net/npm/overmind-mcp@1.0.8/assets/terminal_preview.png)
-
-_Note : L'**OverMind** punit et martyrise les **OpenClaw** qui n'écoutent pas._ 😈
-
-_Projet propulsé par DeaMoN888 - 2026_
+<p align="center">
+  <img src="assets/overmind.png" alt="OverMind-MCP Banner" width="293" height="253">
+</p>
+
+<div align="center">
+
+# 🧠 OverMind-MCP
+
+</div>
+
+_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._
+
+<p align="center">
+  <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>
+  <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>
+</p>
+
+**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.
+
+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.
+
+- 🔌 **Contrôle Total** : Lancez des missions complexes via MCP ou directement via le code (Claude, Gemini, QwenCli, Hermes).
+- 🏗️ **Architecture Pro** : Basé sur des services (`AgentManager`, `ClaudeRunner`, `PromptManager`) pour une stabilité maximale.
+- 🧠 **Mémoire Haute-Performance (4096D)** : Système RAG intégré via PostgreSQL + `pgvector`.
+- 🛡️ **Mémoire Ségréguée** : Chaque agent peut posséder ses propres souvenirs isolés tout en ayant accès au socle global.
+- 🤖 **Multi-Agents** : Créez, configurez et gérez des personnalités d'agents isolées (Prompts & Settings dédiés).
+- 📦 **Prêt pour l'Intégration** : Importable comme un module NPM dans vos autres projets.
+- 🅾️ **HTTP Singleton** : Plus de zombies — 1 serveur HTTP partagé par tous les agents.
+
+---
+
+## 🚀 Installation
+
+### Globale via NPM (Recommandé)
+
+```bash
+npm install -g overmind-mcp@latest
+```
+
+### Configuration MCP (HTTP)
+
+Après installation, configurez votre client MCP avec le模式下 :
+
+```json
+{
+  "mcpServers": {
+    "overmind": {
+      "transport": "http-stream",
+      "url": "http://localhost:3099"
+    },
+    "memory": {
+      "transport": "http-stream",
+      "url": "http://localhost:3099"
+    },
+"postgresql": {
+      "transport": "http-stream",
+      "url": "http://localhost:5433",
+      "description": "PostgreSQL MCP - Base de données vectorielle"
+    }
+  }
+}
+```
+
+---
+
+## 🅾️ Démarrage des Serveurs HTTP
+
+Les serveurs doivent être démarrés avant utilisation :
+
+```bash
+# Overmind (complet) — port 3099
+node dist/bin/cli.js --transport http-stream --port 3099
+
+# PostgreSQL — port 5433
+cd ../serveur_PostGreSQL
+FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=5433 node dist/index.js
+
+# Discord — port 3141
+cd ../serveur_discord
+FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3141 node dist/index.js
+
+# X — port 3142
+cd ../X
+FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3142 node dist/src/server.js
+
+# Debats — port 3100
+cd ../debats-mcp-server
+FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3100 node dist/index.js
+```
+
+| Serveur | Port | Outils |
+|---------|------|--------|
+| Overmind | 3099 | 14 (run_agent, create_agent, memory...) |
+| PostgreSQL | 5433 | 30+ (SQL, vectors, search...) |
+| Discord | 3141 | 88 (members, roles, channels, embeds...) |
+| X | 3142 | Outils X/Twitter |
+| Debats | 3100 | Outils débats |
+
+---
+
+## 🔧 Installation Locale (Dev)
+
+```bash
+git clone https://github.com/DeamonDev888/overmind-mcp.git
+cd overmind-mcp
+pnpm install
+pnpm run build
+```
+
+---
+
+### Utilisation comme Bibliothèque
+
+```typescript
+import { runAgent, AgentManager, updateConfig } from 'overmind-mcp';
+
+// 1. Initialisation
+updateConfig('./settings.json', './mcp.local.json');
+
+// 2. Gestion des agents
+const manager = new AgentManager();
+await manager.createAgent('expert-seo', 'Tu es un expert SEO...', 'claude');
+
+// 3. Lancer une exécution
+const { content, isError } = await runAgent({
+  runner: 'claude',
+  agentName: 'expert-seo',
+  prompt: 'Analyse le site example.com',
+  autoResume: true,
+});
+
+if (!isError) {
+  console.log('🤖 Résultat:', content[0].text);
+}
+```
+
+---
+
+## 📂 Structure du Projet
+
+```
+Workflow/
+├── 📦 bin/                    # Scripts d'installation
+├── 🐳 docker/                 # Configuration Docker
+├── 🗄️ db/                     # Scripts base de données
+├── ⚙️ config/                 # Configurations MCP
+├── 📚 docs/                   # Documentation
+├── 💻 src/                    # Code source
+│   ├── bin/                   # Points d'entrée CLI
+│   ├── lib/                   # Bibliothèques partagées
+│   ├── services/              # Services métier
+│   └── tools/                # Outils MCP
+├── 🧪 tests/                  # Tests unitaires
+└── 🔧 scripts/               # Scripts de maintenance
+```
+
+---
+
+## 🛡️ Anti-Zombie Architecture
+
+L'ancien problème : chaque agent spawn son propre node.exe MCP server → zombies.
+
+La solution : 1 seul serveur HTTP par service, partagé par tous les agents.
+
+```
+Agent 1 ──┐
+Agent 2 ──┼──→ Overmind:3099 (1 process)
+Agent 3 ──┘
+         └──→ PostgreSQL:5433 (1 process)
+         └──→ Discord:3141 (1 process)
+```
+
+Plus de node.exe par agent = plus de zombies.
+
+---
+
+![Aperçu du Terminal](https://cdn.jsdelivr.net/npm/overmind-mcp@1.0.8/assets/terminal_preview.png)
+
+_Projet propulsé par DeaMoN888 - 2026_

package/bin/README.md

@@ -1,34 +1,44 @@
-# 📦 Installation Scripts
-
-Ce dossier contient les scripts d'installation d'OverMind MCP.
-
-## 📜 Fichiers
-
-- **install-overmind-unix.sh** - Script d'installation pour Linux/macOS
-- **install-overmind-windows.bat** - Script d'installation pour Windows
-
-## 🚀 Utilisation
-
-### Windows
-```batch
-cd bin
-install-overmind-windows.bat
-```
-
-### Linux/macOS
-```bash
-cd bin
-chmod +x install-overmind-unix.sh
-./install-overmind-unix.sh
-```
-
-## 📋 Ce qui est installé
-
-- OverMind MCP (NPM package)
-- PostgreSQL + pgvector (Docker)
-- RabbitMQ (Docker)
-- Temporal (Docker)
-- Prometheus (Docker)
-- Grafana (Docker)
-- Jaeger (Docker)
-- Redis (Docker)
+# 📦 Installation Scripts
+
+Ce dossier contient les scripts d'installation d'OverMind MCP.
+
+## 📜 Fichiers
+
+- **install-overmind-unix.sh** - Script d'installation pour Linux/macOS
+- **install-overmind-windows.bat** - Script d'installation pour Windows
+
+## 🚀 Utilisation
+
+### Windows
+```batch
+cd bin
+install-overmind-windows.bat
+```
+
+### Linux/macOS
+```bash
+cd bin
+chmod +x install-overmind-unix.sh
+./install-overmind-unix.sh
+```
+
+## 📋 Ce qui est installé
+
+- OverMind MCP (NPM package)
+- PostgreSQL + pgvector (Docker)
+- Prometheus (Docker)
+- Grafana (Docker)
+- Jaeger (Docker)
+
+## 🅾️ Démarrage des Serveurs HTTP
+
+Après installation, lancez les serveurs MCP sur les ports suivants :
+
+| Serveur | Port | Commande |
+|---------|------|----------|
+| Overmind (complet) | 3099 | `node dist/bin/cli.js --transport http-stream --port 3099` |
+| Overmind (memory) | 3099 | `node dist/bin/cli.js --memory-tools-only --transport http-stream --port 3099` |
+| PostgreSQL | 5433 | `FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=5433 node dist/index.js` |
+| Discord | 3141 | `FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3141 node dist/index.js` |
+| X | 3142 | `FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3142 node dist/src/server.js` |
+| Debats | 3100 | `FORCE_COLOR=0 FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3100 node dist/index.js` |

package/bin/install-overmind-windows.bat

@@ -122,10 +122,54 @@ netstat -an | findstr ":3000 " >nul && echo %ESC%[93m[WARN] Port 3000 utilise%ES
 echo.
 
 REM ============================================================
-REM STEP 5: PostgreSQL intelligent
+REM STEP 5: Configuration MCP HTTP
 REM ============================================================
 echo %ESC%[36m=======================================================%ESC%
-echo %ESC%[36m[ STEP 5/8 ] POSTGRESQL INTELLIGENT%ESC%
+echo %ESC%[36m[ STEP 5/8 ] CONFIGURATION MCP HTTP%ESC%
+echo %ESC%[36m=======================================================%ESC%
+echo.
+echo [INFO] Creation configuration MCP HTTP singleton...
+if not exist "%USERPROFILE%\.overmind\config" mkdir "%USERPROFILE%\.overmind\config"
+
+(
+    echo {
+    echo   "mcpServers": {
+    echo     "overmind": {
+    echo       "transport": "http-stream",
+    echo       "url": "http://localhost:3099"
+    echo     },
+    echo     "memory": {
+    echo       "transport": "http-stream",
+    echo       "url": "http://localhost:3099"
+    echo     },
+    echo     "postgresql": {
+    echo       "transport": "http-stream",
+    echo       "url": "http://localhost:5433"
+    echo     },
+    echo     "discord": {
+    echo       "transport": "http-stream",
+    echo       "url": "http://localhost:3141"
+    echo     },
+    echo     "x": {
+    echo       "transport": "http-stream",
+    echo       "url": "http://localhost:3142"
+    echo     }
+    echo   }
+    echo }
+) > "%USERPROFILE%\.overmind\config\mcp-servers.json"
+
+echo %ESC%[92m[OK] Configuration MCP creee: %USERPROFILE%\.overmind\config\mcp-servers.json%ESC%
+echo.
+echo [INFO] Ports a lancer manuellement apres installation:
+echo    Overmind:   node cli.js --transport http-stream --port 3099
+echo    PostgreSQL: node dist/index.js (FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=5433)
+echo    Discord:    node dist/index.js (FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3141)
+echo    X:          node dist/src/server.js (FASTMCP_TRANSPORT=httpStream FASTMCP_PORT=3142)
+echo.
+
+REM STEP 6: PostgreSQL intelligent
+echo %ESC%[36m=======================================================%ESC%
+echo %ESC%[36m[ STEP 6/8 ] POSTGRESQL INTELLIGENT%ESC%
 echo %ESC%[36m=======================================================%ESC%
 echo.
 
@@ -153,10 +197,10 @@ if "%USE_EXTERNAL_POSTGRES%"=="1" (
 echo.
 
 REM ============================================================
-REM STEP 6: Configuration intelligente
+REM STEP 7: Configuration MCP .mcp.json
 REM ============================================================
 echo %ESC%[36m=======================================================%ESC%
-echo %ESC%[36m[ STEP 6/8 ] CONFIGURATION ADAPTATIVE%ESC%
+echo %ESC%[36m[ STEP 7/8 ] CONFIGURATION MCP .MCP.JSON%ESC%
 echo %ESC%[36m=======================================================%ESC%
 echo.
 
@@ -193,10 +237,10 @@ if not exist "%USERPROFILE%\.overmind\.env" (
 echo.
 
 REM ============================================================
-REM STEP 7: Telecharger docker-compose
+REM STEP 8: Telechargement docker-compose
 REM ============================================================
 echo %ESC%[36m=======================================================%ESC%
-echo %ESC%[36m[ STEP 7/8 ] TELECHARGEMENT CONFIG%ESC%
+echo %ESC%[36m[ STEP 8/8 ] TELECHARGEMENT CONFIG%ESC%
 echo %ESC%[36m=======================================================%ESC%
 echo.
 
@@ -282,7 +326,7 @@ REM ============================================================
 REM STEP 8: Demarrage intelligent
 REM ============================================================
 echo %ESC%[36m=======================================================%ESC%
-echo %ESC%[36m[ STEP 8/8 ] DEMARRAGE DOCKER%ESC%
+echo %ESC%[36m[ STEP 8/8 ] DEMARRAGE DOCKER ET SERVEURS HTTP%ESC%
 echo %ESC%[36m=======================================================%ESC%
 echo.