🚀 MCP Orchestrator - Serveur d`orchestration SSH/SFTP

Un serveur MCP (Model-Context-Protocol) puissant pour l'orchestration de tâches distantes. Il gère des connexions SSH et SFTP, une file d'attente de tâches persistante, et expose un ensemble riche d'outils pour la gestion de serveurs, le monitoring, et l'exécution de commandes via une interface stdio compatible avec les LLM.

✨ Fonctionnalités Principales

🔐 Gestion de Serveurs

• ✅ Configuration multi-serveurs avec alias
• ✅ Support authentification par clé SSH ou mot de passe
• ✅ Stockage sécurisé des configurations

📡 Exécution SSH

• ✅ Commandes simples et séquences
• ✅ Mode interactif avec auto-réponse aux prompts
• ✅ Streaming pour logs (PM2, Docker, tail, journalctl)
• ✅ Pool de connexions persistantes
• ✅ Retry automatique en cas d`échec

📁 Transferts SFTP

• ✅ Upload/Download de fichiers et dossiers
• ✅ Support patterns glob (*.txt, **/*.js)
• ✅ Transferts multiples en une seule commande
• ✅ Création automatique des dossiers parents

📊 Monitoring & APIs

• ✅ Monitoring système (CPU, RAM, Disque)
• ✅ Statut des services (systemd, Docker, PM2)
• ✅ Health checks HTTP/HTTPS avec authentification
• ✅ Catalogue d`APIs personnalisable
• ✅ Fail2Ban status

🎯 Gestion de Tâches

• ✅ Queue persistante avec sauvegarde automatique
• ✅ Exécution hybride (sync/async)
• ✅ Historique des commandes
• ✅ Retry manuel et automatique
• ✅ Statistiques détaillées

📦 Installation

Vous avez deux méthodes pour utiliser cet outil :

Méthode 1 : Via NPM (Recommandé)

C'est la méthode la plus simple. L'outil sera téléchargé et exécuté à la demande par npx.

Enregistrez ce MCP auprès de votre client (ex: gemini-cli) avec la configuration suivante :

{
  "mcpServers": {
    "orchestrator": {
      "command": "npx",
      "args": [
        "@fkom13/mcp-sftp-orchestrator"
      ],
      "env": {
        "MCP_DATA_DIR": "/chemin/absolu/vers/votre/dossier/de/donnees"
      }
    }
  }
}

Important : Remplacez /chemin/absolu/vers/votre/dossier/de/donnees par un chemin réel sur votre machine, par exemple ~/.config/mcp-orchestrator.

Méthode 2 : Depuis les Sources (Git)

Cette méthode est utile si vous souhaitez modifier le code.

1. Clonez le dépôt :

   git clone https://github.com/fkom13/mcp-sftp-orchestrator.git
   cd mcp-sftp-orchestrator
   

2. Installez les dépendances :

   npm install
   

3. Configurez votre client MCP pour lancer le script localement :

   {
     "mcpServers": {
       "orchestrator": {
         "command": "node",
         "args": [
           "/chemin/vers/mcp-sftp-orchestrator/server.js"
         ],
         "env": {
           "MCP_DATA_DIR": "/chemin/vers/mcp-sftp-orchestrator/data"
         }
       }
     }
   }
   

🛠️ Configuration

La configuration du serveur se fait par ordre de priorité :

1. Variables d'environnement du client MCP (le bloc env dans votre JSON) : Priorité la plus haute. C'est la méthode recommandée pour définir le dossier de données.
2. Fichier .env : Si vous lancez le projet localement (méthode 2), vous pouvez créer un fichier .env à la racine. Il sera utilisé si la variable n'est pas définie par le client MCP.
3. Valeurs par défaut : Si rien n'est défini, le dossier de données par défaut sera ~/.config/mcp-orchestrator.

Variables disponibles :

• MCP_DATA_DIR: (Recommandé) Le dossier où seront stockées les données (configurations des serveurs, historique, etc.).
• MCP_SYNC_TIMEOUT_S: Le délai en secondes avant qu'une tâche longue ne passe en arrière-plan. Par défaut : 30.

--

... View full README on GitHub