Serveur MCP Terminal Controller

Que fait le serveur MCP “Terminal Controller” ?

Le serveur MCP Terminal Controller est un serveur Model Context Protocol (MCP) conçu pour permettre l’exécution sécurisée de commandes terminal, la navigation dans les répertoires et les opérations sur le système de fichiers via une interface standardisée. Il agit comme un pont entre les assistants IA et l’environnement hôte, permettant aux agents IA d’effectuer des tâches telles que l’exécution de commandes shell, la gestion des dossiers et la manipulation programmée de fichiers. Grâce à des protections de sécurité intégrées, le suivi de l’historique des commandes et une compatibilité multiplateforme, Terminal Controller améliore les workflows de développement en offrant aux outils IA un accès contrôlé au terminal et au système de fichiers d’une machine. Cette capacité permet aux assistants IA d’automatiser, d’explorer et de gérer les tâches système pour les développeurs, de façon sûre et standardisée.

Liste des prompts

Aucun modèle de prompt n’a été trouvé dans le dépôt ou la documentation.

Liste des ressources

Aucune ressource MCP explicite n’a été définie dans le dépôt ou la documentation.

Liste des outils

• Exécution de commandes : Permet d’exécuter des commandes terminal avec contrôles de temporisation et capture de la sortie complète.
• Gestion des répertoires : Permet la navigation et l’affichage du contenu des dossiers avec un formatage intuitif.
• Opérations sur fichiers : Prend en charge la lecture, l’écriture, la mise à jour, l’insertion et la suppression de contenu à la précision de la ligne.
• Historique des commandes : Suit et affiche les dernières commandes exécutées pour l’audit et la reproductibilité.

Cas d’usage de ce serveur MCP

• Exécution automatisée de commandes : Les développeurs peuvent demander aux assistants IA de lancer en toute sécurité des commandes shell pour la compilation, les tests ou le déploiement du code, avec capture des sorties et erreurs.
• Gestion de fichiers et de dossiers : Les agents IA peuvent aider à organiser, parcourir ou manipuler les fichiers et dossiers, facilitant l’automatisation de l’exploration du code ou de la mise en place d’environnements.
• Scripting sécurisé : Les protections intégrées aident à prévenir l’exécution de commandes dangereuses, réduisant le risque lors de l’accès terminal par l’IA.
• Surveillance et audit système : L’historique des commandes permet de tracer les actions réalisées, utile pour les audits et la transparence des workflows.
• Développement multiplateforme : En prenant en charge Windows et les systèmes UNIX, le serveur MCP offre une expérience de développement cohérente sur des environnements variés.

Comment le configurer

Windsurf

1. Vérifiez que Python 3.11+ est installé.
2. Installez le package via PyPI :

   pip install terminal-controller
   

3. Modifiez le fichier de configuration Windsurf pour ajouter le serveur MCP :

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Sauvegardez la configuration et redémarrez Windsurf.
5. Vérifiez que le serveur MCP fonctionne et est accessible.

Claude

1. Installez Python 3.11+ sur votre machine.
2. Pour Claude Desktop, installez via Smithery :

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. Ou installez via PyPI :

   pip install terminal-controller
   

4. Ajoutez ceci à votre configuration Claude :

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. Redémarrez Claude Desktop et vérifiez que le serveur MCP est détecté.

Cursor

1. Vérifiez que Node.js et Python 3.11+ sont installés.
2. Installez terminal-controller :

   pip install terminal-controller
   

3. Ajoutez le serveur MCP à votre configuration Cursor :

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Sauvegardez le fichier et redémarrez Cursor.
5. Confirmez l’intégration en vérifiant la liste des outils dans Cursor.

Cline

1. Assurez-vous que Python 3.11+ est disponible.
2. Installez le serveur MCP :

   pip install terminal-controller
   

3. Ajoutez cet extrait à votre configuration Cline :

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Redémarrez Cline après avoir sauvegardé les modifications.
5. Testez en exécutant une commande simple via l’interface MCP.

Sécurisation des clés API

Si des clés API ou des secrets sont nécessaires dans votre configuration, utilisez des variables d’environnement plutôt que de les coder en dur. Exemple de configuration :

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

Comment utiliser ce MCP dans des flows

Utilisation de MCP dans FlowHunt

Pour intégrer des serveurs MCP à votre workflow FlowHunt, commencez par ajouter le composant MCP à votre flow et connectez-le à votre agent IA :

Cliquez sur le composant MCP pour ouvrir le panneau de configuration. Dans la section configuration système MCP, saisissez les informations de votre serveur MCP au format JSON suivant :

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Une fois configuré, l’agent IA pourra utiliser ce MCP comme outil avec accès à toutes ses fonctions et capacités. N’oubliez pas de remplacer “terminal-controller” par le nom réel de votre serveur MCP et de mettre votre propre URL de serveur MCP.

Aperçu

Au vu de ce qui précède, Terminal Controller MCP apporte un accès essentiel et sécurisé au terminal et système de fichiers, mais n’inclut ni modèles de prompt ni ressources explicites. Sa configuration est bien documentée et multiplateforme. Les notions de racines et d’échantillonnage ne sont pas abordées. Globalement, c’est un serveur pratique, sûr et relativement simple pour des besoins DevOps ou d’automatisation de base.

Score MCP