MCP SFTP Orchestrator

Récupère le statut de tous les services connus (systemd, Docker, PM2) sur un serveur.

Récupère les métriques système vitales (CPU, RAM, Disque) d'un serveur.

Manuel pour l'IA pilote : workflows copier-coller, cheatsheet, pièges à éviter. Complémentaire de 'help' (qui liste les outils). Appelle guide (section:'index') en début de session pour charger les bonnes pratiques.

Affiche la documentation complète d'un outil ou la liste de tous les outils disponibles.

Vue combinée : version orchestrator, serveurs (secrets masqués), groupes, notes, projets, crashed jobs, pool stats. Idéal en début de session.

Vue légère du parc sans alias; avec alias/group:/all, découverte live des ports, Docker/Compose, PM2, systemd et Nginx avec corrélation domaine → proxy → port → conteneur/service.

Ajoute un pattern de commande à la liste noire. Le pattern peut contenir * comme joker.

Affiche la liste des patterns de commandes bloquées par la politique de sécurité.

Supprime un pattern de commande de la liste noire.

Affiche les statistiques du pool de connexions SSH persistantes.

Compare le path local et le path remote du projet (ignorePatterns du registre). includeDiff pour le détail.

Retourne la config complète d'un projet (local, servers, ignore, runtime).

Registre sémantique projet ↔ serveur(s) ↔ paths local/remote.

Retourne { local, remote, ignore, runtime } prêts pour file_* / project_diff.

Enregistre un projet. Ex: { name:'p-image', local:{path:'…'}, servers:{prod:{alias:'fkomprodmini2_prod', path:'/home/ubuntu/p-image', runtime:{pm2:'p-image', port:5002}}}, ignore:['node_modules'] }

Affiche les statistiques détaillées de la queue de tâches.

Enregistre ou met à jour les informations de connexion d'un serveur. Vous devez fournir soit un chemin de clé, soit un mot de passe.

Affiche les groupes de serveurs (oci, contabo, …). Utilisable dans task_exec via alias 'group:nom' ou le nom du groupe.

Supprime un groupe (ne supprime pas les serveurs).

Définit un groupe nommé pointant vers une liste d'alias serveurs existants.

hostname, disk, mem, pm2, docker, top-level $HOME, présence tailscale. force:true pour rafraîchir.

Affiche la liste de tous les alias de serveurs configurés avec leurs détails.

Récupère le contexte enregistré d'un serveur (description, services, warnings, conventions, dernière intervention). À consulter avant d'intervenir sur un serveur.

Vue d'ensemble des notes/protocoles de tout le parc.

Supprime le contexte enregistré d'un serveur.

Attache un contexte à un serveur pour ne pas se perdre dans le parc : description, services critiques, avertissements, conventions, note libre. Merge partiel (seuls les champs fournis sont modifiés). 'intervention' met à jour automatiquement last_intervention.

Supprime un alias de serveur de la configuration.

Termine proprement une session shell (ferme le shell et la connexion SSH dédiée). À faire quand la session n'est plus nécessaire. Les sessions inactives sont aussi fermées automatiquement après 30 min.

Ouvre un shell PTY persistant sur un serveur distant où cd, export, activations d'env PERSISTENT entre les commandes (contrairement à task_exec qui isole chaque commande). Retourne un sessionId à utiliser avec shell_exec. Fermer avec shell_close quand terminé.

Exécute une commande dans une session shell existante (créée via shell_create). L'état (répertoire courant, variables) PERSISTE entre les appels. Retourne { output, exitCode, timedOut }. Une seule commande à la fois par session. Respecte la blocklist (skip_policy:true pour forcer).

Affiche toutes les sessions shell persistantes en cours avec leur état (alias, âge, inactivité, nombre de commandes, occupée/fermée).

Capture l'état de fichiers/dossiers critiques (localhost sans SSH, ou serveur distant via SFTP). Déduplication automatique par contenu (hash). Idéal avant une modification risquée. Retourne un snapshotId.

Supprime un snapshot et nettoie les blobs devenus orphelins (dedup-aware : ne supprime que les contenus plus référencés). Retourne l'espace libéré.

Diff entre deux snapshots (par chemin). Fonctionne même entre un snapshot local et un snapshot remote (détection de drift local↔prod). includeDiff:true pour le détail ligne à ligne.

Affiche les snapshots filtrés par source (localhost, serveur, tag). Résumé léger (id, serveur, tag, date, nb fichiers).

Restaure les fichiers d'un snapshot vers une cible (local ou remote). DANGEREUX : dryRun:true par défaut (prévisualisation). Restauration réelle exige dryRun:false ET force:true. Peut restaurer un snapshot remote vers local (backup) et inversement (déploiement).

Ajoute une clé PUBLIQUE dans authorized_keys d'un serveur. source: string|local_path|.pub|alias (dérive .pub depuis keyPath). Ne copie JAMAIS de private key. dry_run:true par défaut.

Exécute un diagnostic complet du système MCP.

Équivalent de tail -n pour afficher les dernières lignes d'un fichier distant.

Description is built at runtime.

Exécute une commande SSH avec gestion des prompts interactifs (yes/no, passwords, etc.).

Exécute plusieurs commandes SSH en séquence sur le même serveur.

Historique récent des tâches, filtrable par alias et paginable. Utiliser task_status pour le détail complet d'un job précis.

Affiche les logs du système MCP.

Supprime de la queue les jobs crashed/failed/completed. dry_run:true pour compter sans supprimer. olderThanDays optionnel.

Affiche la queue récente. Filtrable par statut et paginable pour éviter de déverser des centaines de jobs dans le contexte.

Relance une tâche qui a échoué ou crashé.

Relance en masse les jobs retryables (crashed et/ou failed). dry_run:true pour lister sans exécuter.

Récupère les détails d'une seule tâche, avec un rappel si nécessaire.

Description is built at runtime.

Lance des transferts SFTP multiples avec support de patterns glob (*, ?, []).

Description is built at runtime.

Test

Un test simple

Test avec paramètres

Crée une nouvelle session tmux sur un serveur distant. La session survit aux déconnexions et aux redémarrages du MCP.

Envoie une commande à une session tmux existante.

Supprime une session tmux.

Liste toutes les sessions tmux actives sur un serveur.

Récupère le contenu affiché dans une session tmux.

Autorise un port pour les tunnels SSH (sécurité).

Supprime un port de la liste des ports autorisés.

Ferme un tunnel SSH par son nom.

Crée un tunnel SSH (local/remote/SOCKS5). source=null → local, source=alias → tmux sur le serveur distant. Le tunnel persiste via tmux si source est un serveur.

Liste tous les tunnels SSH actifs et leur état.

Ferme la session et met à jour last_intervention sur la note serveur (note:true).

Ouvre un journal d'intervention (option snapshot). Retourne sessionId. Fermer avec work_end (met à jour server_note).