Desktop Commander MCP

Qu'est-ce que Desktop Commander MCP ?

Desktop Commander MCP est un serveur Model Context Protocol (MCP) qui permet une interaction avancée au niveau système entre des modèles de langage IA (comme Claude Desktop) et votre machine locale. Il va bien au-delà des éditeurs IA typiques en enveloppant des outils essentiels pour les développeurs - commandes terminales, gestion de fichiers, édition de code et automatisation - derrière une interface sécurisée qui fonctionne directement via Claude Desktop, sans nécessiter de crédits API par jeton. Il est conçu pour transformer Claude en un assistant développeur polyvalent capable d'exploration complète de code, de modifications précises, de scripts d'automatisation et de gestion des flux de travail à travers tout votre système d'exploitation, et pas seulement à l'intérieur d'un IDE.

Comment configurer Desktop Commander MCP

Installez Claude Desktop : Téléchargez et installez Claude Desktop.
Installation rapide via npx : Exécutez npx @wonderwhy-er/desktop-commander@latest setup dans votre terminal.
Autres options d'installation :
- Utilisez le CLI de Smithery avec npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
- Utilisez le script bash pour macOS : curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash
- Modifiez votre claude_desktop_config.json, en ajoutant la configuration du serveur sous mcpServers
- Ou clonez/construisez localement avec git clone ..., npm run setup.
Redémarrez Claude Desktop après la configuration pour activer le nouveau serveur MCP.
Configurer les paramètres :
- Utilisez get_config({}) et set_config_value({ key, value }) dans le chat Claude pour ajuster des options telles que les commandes bloquées, les répertoires autorisés, ou le shell par défaut.
- Vérifiez toujours les modifications de configuration avec get_config({}).
- Pour des raisons de sécurité, maintenez un chat de configuration dédié et spécifiez les limites d'accès exactes aux répertoires.

Les paramètres sont conservés dans config.json dans le répertoire de travail du serveur. Vous pouvez désactiver la télémétrie directement en demandant à Claude de "désactiver la télémétrie" dans le chat.

Comment utiliser Desktop Commander MCP

Démarrez Claude Desktop et ouvrez un nouveau chat.
Interagissez en utilisant un langage naturel : Demandez à Claude d'exécuter des opérations telles que lire, rechercher, modifier des fichiers, exécuter des commandes terminales, ou gérer des processus - Claude invoquera les outils MCP correspondants.

Appels manuels d'outils : Vous pouvez utiliser directement les noms de fonction des outils MCP, par exemple :

execute_command({ "command": "ls -la", "shell": "/bin/zsh" })
read_file({ "path": "README.md" })
edit_block({ "changes": "...modifier le format de bloc..." })

Gestion des tâches de longue durée :
- Pour les processus qui se poursuivent en arrière-plan, utilisez list_sessions pour surveiller, read_output pour récupérer la sortie de commande, et force_terminate pour les arrêter.
Recherche et modification de texte/code :
- Utilisez la syntaxe de bloc d'édition pour des remplacements précis.
- Utilisez des outils comme search_code, search_files, et edit_block pour réaliser et coordonner des modifications sophistiquées de code.
Changement de shells :
- Sélectionnez votre shell préféré via l'argument shell dans les outils de commande - par exemple, bash, zsh ou powershell.

L'interface vous permet d'automatiser les tâches en toute transparence, d'effectuer des scripts systèmes, de gérer des fichiers et des processus, et de modifier du code - le tout grâce à des conversations avec Claude.

Fonctionnalités clés

Exécution de commandes terminales : Exécutez des commandes avec sortie en direct, délais et shells personnalisés.
Gestion des processus en arrière-plan : Listez, surveillez et tuez des processus ou des sessions terminales en cours d'exécution.
Gestion de la configuration : Obtenez/réglez les paramètres du serveur, y compris les restrictions de commande et l'accès aux répertoires sans avoir besoin de redémarrer.
Opérations sur le système de fichiers : Lisez, écrivez, déplacez, recherchez et obtenez des informations sur les fichiers/répertoires ; prend en charge les opérations par lots et les recherches par motifs.
Recherche/édition d'archives : Recherche et remplacements de texte/code flous et multi-occurrences utilisant des formats de bloc d'édition sécurisés.
Édition avancée de code : Modifications textuelles chirurgicales, prise en charge de plusieurs fichiers, correspondance de motifs et intégration avec ripgrep pour une exploration approfondie du code.
Gestion des images et des URL : read_file peut prévisualiser et analyser à la fois des fichiers locaux et des ressources Web distantes, prenant en charge à la fois des données textuelles et des images.
Contrôles de sécurité : Définissez des répertoires autorisés, bloquez des commandes risquées et examinez la télémétrie (option de désinscription prise en charge).
Multi-plateforme : Fonctionne entièrement sur macOS, Windows et Linux, avec des corrections automatiques spécifiques à l'environnement.

Cas d'utilisation

Explorer, rechercher et comprendre de grandes ou complexes bases de code en quelques minutes
Refactoring ou patching chirurgical précis de code sur plusieurs fichiers/projets
Générer de la documentation ou des diagrammes en extrayant et en traitant du code/texte
Automatiser des tâches répétitives ou de développement cross-projet à partir d'une seule interface de chat
Effectuer du scripting système, de la configuration d'environnement et de la gestion des processus via IA
Debugger rapidement, exécuter des essais ou terminer des processus, des constructions, et des exécutions de serveur
Travailler à travers plusieurs environnements OS sans coût par jeton de l'API

FAQ

1. Qu'est-ce que Desktop Commander MCP ? C'est un serveur MCP qui permet à Claude Desktop d'interagir pleinement avec votre système de fichiers et votre OS, facilitant des tâches telles que l'exploration de code, l'édition de code fine, l'automatisation et le contrôle du terminal/des processus via un langage naturel.

2. En quoi cela diffère-t-il des outils comme Cursor ou Windsurf ? Desktop Commander MCP offre un contrôle complet au niveau système au-delà de tout IDE, prend en charge des flux de travail multi-projets et multi-répertoires, fournit un accès total aux fichiers (et non par morceaux), et exploite le plan Pro de Claude Desktop sans coûts d'API supplémentaires par jeton.

3. Desktop Commander nécessite-t-il des crédits API ou un paiement supplémentaire ? Non — une fois que vous avez Claude Desktop Pro, toutes les opérations se font localement sans coûts d'utilisation ou charges par jeton supplémentaires.

4. Comment mettre à jour Desktop Commander ? Si installé via npx ou Smithery, Desktop Commander se met à jour automatiquement lorsque vous redémarrez Claude Desktop. Pour les installations manuelles, il suffit de relancer la commande de configuration.

5. Des données de télémétrie sont-elles collectées ? La télémétrie est minimale et non personnelle par défaut. Vous pouvez vous désinscrire à tout moment en demandant à Claude : "désactiver la télémétrie".

Nom du Protocole	Description
get_config	Récupère la configuration actuelle du serveur (commandes bloquées, shell par défaut, répertoires autorisés) au format JSON.
set_config_value	Met à jour une valeur de configuration spécifique telle que les répertoires autorisés, les commandes bloquées, ou le shell par défaut.
execute_command	Exécute une commande terminale avec options pour le délai d'attente et la sélection du shell, diffuse la sortie de la commande.
read_output	Récupère la nouvelle sortie d'une commande/session terminale en cours d'exécution.
force_terminate	Termine de force une session ou une commande terminale en cours d'exécution par id de session.
list_sessions	Liste toutes les sessions de commande terminale en cours d'exécution ou mises en arrière-plan.
list_processes	Affiche tous les processus OS en cours d'exécution avec des informations détaillées (PID, commande, etc.).
kill_process	Termine un processus par son identifiant de processus (PID).
read_file	Lit et retourne le contenu d'un fichier local ou d'une URL ; prend en charge les données textuelles et d'image.
read_multiple_files	Lit le contenu de plusieurs fichiers à la fois (opération par lots).
write_file	Réécrit un fichier entier avec un nouveau contenu (adapté pour de grands changements).
create_directory	Crée un nouveau répertoire ou s'assure qu'il existe.
list_directory	Fournit une liste détaillée des fichiers et sous-répertoires à un chemin donné.
move_file	Déplace ou renomme des fichiers ou des répertoires.
search_files	Trouve des fichiers par nom avec correspondance de sous-chaînes sans distinction de majuscules et recherche floue.
search_code	Recherche dans le contenu des fichiers des motifs de texte/code (alimenté par ripgrep) de manière récursive.
get_file_info	Récupère des métadonnées détaillées sur un fichier ou un répertoire (par exemple, taille, horodatages, type).
edit_block	Effectue des remplacements textuels/code précis basés sur des motifs en utilisant un format de bloc d'édition pour des changements chirurgicaux.