Desktop Commander (MCP server) — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Outil edit_block chirurgical pour des modifications style diff — sans réécriture de fichier entier
Commandes terminal avec délais d'expiration et suivi de processus en arrière-plan
Répertoires allowed_directories configurables pour que Claude ne sorte pas de votre espace de travail
Recherche dans les fichiers à la vitesse de ripgrep
Support de lecture d'images pour les captures d'écran et fichiers de design

Démo en direct

Aperçu en pratique

desktop-commander-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "desktop-commander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "desktop-commander-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "desktop-commander-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@wonderwhy-er/desktop-commander"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add desktop-commander-mcp -- npx -y @wonderwhy-er/desktop-commander

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Desktop Commander

Utiliser Claude Desktop comme agent de codage gratuit sans Cursor ni Claude Code

👤 Développeurs qui veulent du codage agentique sans payer d'abonnement IDE ⏱ ~20 min beginner

Quand l'utiliser : Vous avez déjà Claude Desktop et voulez qu'il édite vraiment votre dépôt, pas seulement coller des extraits.

Prérequis

Claude Desktop installé — Télécharger depuis claude.ai/download
Répertoire de travail en liste blanche — Le premier lancement demande quels répertoires Claude peut toucher

Déroulement

Installer et verrouiller l'espace de travail

Install desktop-commander. Limit it to ~/Code/myproject — nothing outside.✓ Copié

→ La configuration montre les allowed_directories restreints ; la liste des outils apparaît dans Claude
Effectuer un vrai changement

Open ~/Code/myproject. Find every TODO comment, group by file, propose fixes for the top 5.✓ Copié

→ Analyse rapide à la ripgrep, liste priorisée avec numéros de lignes
Appliquer avec edit_block

Apply the proposed fixes using edit_block. Don't rewrite whole files — just the necessary diffs.✓ Copié

→ Chaque modification montre des blocs old_string/new_string ; diff git propre ensuite

Résultat : Claude Desktop écrit de vrais changements de code dans votre dépôt avec la même qualité qu'un assistant IDE payant.

Pièges

Oublié de définir les allowed_directories — Claude scanne votre dossier personnel — Éditez ~/.claude-server-commander/config.json et redémarrez Claude Desktop

Combiner avec : github · filesystem

Lancer des serveurs de développement et capturer la sortie sans bloquer le chat

👤 Développeurs déboguant des configurations multi-processus ⏱ ~25 min intermediate

Quand l'utiliser : Vous avez besoin que Claude démarre un serveur, lance des tests dans un autre terminal et suive les logs simultanément.

Déroulement

Démarrer le serveur en arrière-plan

Start npm run dev as a background process. Show me the PID.✓ Copié

→ Processus démarré, PID retourné, capture du flux de sortie
Lancer les tests contre lui

While that's running, execute the e2e suite and surface any failures.✓ Copié

→ Tests exécutés indépendamment ; le serveur continue de streamer
Inspecter les logs à la demande

Show the last 100 lines of stdout from PID 12345. Anything red?✓ Copié

→ Tranche de log avec erreurs mises en évidence

Résultat : Session de débogage multi-processus orchestrée entièrement depuis Claude.

Pièges

Le processus en arrière-plan continue après la fin du chat — Utilisez l'outil kill_process quand vous avez terminé, ou redémarrez Claude Desktop

Refactoriser en masse sur des centaines de fichiers en une session

👤 Développeurs effectuant des migrations à l'échelle de la base de code (ex. renommage, dépréciation) ⏱ ~60 min intermediate

Quand l'utiliser : Votre assistant IDE coince sur plus de 50 fichiers modifiés ; vous voulez un passage orchestré unique.

Déroulement

Délimiter le changement

Find every import of oldLib. Group by file and tell me how many changes per file.✓ Copié

→ Histogramme d'impact
Tester sur un fichier d'abord

Apply the migration to the smallest-impact file as a smoke test.✓ Copié

→ Fichier unique migré ; tests passent
Déployer par lots

Now apply to the next 20 files. After each batch, run lint and tell me if anything breaks.✓ Copié

→ Rapports de progression par lot avec bilan de santé

Résultat : Migration sur toute la base de code complétée avec des points de contrôle vérifiables par lot.

Pièges

edit_block échoue sur des différences d'espaces blancs — Utilisez le mode recherche-remplacement pour les motifs délicats ; vérifiez le mode fin de ligne

Combiner avec : github

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

desktop-commander-mcp + github

Édition locale puis création de PR

Apply the fixes via desktop-commander, then use github MCP to open a PR with a clean summary.✓ Copié

desktop-commander-mcp + filesystem

Comparer différents accès filesystem sandboxés

Use filesystem MCP for read-only library scans and desktop-commander for actual project edits.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler
execute_command	command: str, timeout_ms?: int	Toute action shell — git, npm, scripts de build
edit_block	file_path, old_string, new_string	Éditions chirurgicales — sans réécriture de fichier entier
read_file	path	Lire le source pour le contexte
write_file	path, content	Création de nouveau fichier
search_files	path, pattern	Trouver des fichiers par nom/glob
search_code	pattern, path?	Recherche de contenu dans les fichiers
list_processes	()	Voir ce qui tourne dans la session

Coût et limites

Coût d'exécution

Quota d'API: N/A — local
Tokens par appel: Variable — les gros fichiers consomment des tokens
Monétaire: Gratuit (MIT)
Astuce: Utilisez search_code plutôt que read_file quand vous n'avez besoin que de quelques lignes

Sécurité

Permissions, secrets, portée

Portées minimales : filesystem-read filesystem-write shell-exec

Stockage des identifiants : Aucun — tout est local

Sortie de données : Aucun — tous les appels sont locaux

Ne jamais accorder : Unrestricted root directory access

execute_command peut exécuter n'importe quoi — gardez les allowed_directories restreints
N'accordez pas l'accès à ~/.ssh ou aux répertoires de credentials

Dépannage

Erreurs courantes et correctifs

Permission refusée sur edit_block

Ajoutez le répertoire aux allowed_directories dans ~/.claude-server-commander/config.json

Vérifier : cat the config and restart Claude Desktop

Processus démarré mais aucune sortie

Utilisez read_output avec le PID ; la sortie est mise en mémoire tampon, pas streamée dans le chat par défaut

edit_block signale 'old_string not found'

Dérive d'espaces blancs ou de fins de ligne — relisez le fichier d'abord pour copier les octets exacts

Alternatives

Desktop Commander vs autres

Alternative	Quand l'utiliser	Compromis
Claude Code (CLI)	Vous voulez la boucle agentique officielle Anthropic avec planification	Claude Code est plus abouti mais nécessite son propre abonnement ; Desktop Commander est gratuit
filesystem (official MCP)	Accès fichier en lecture seule ou sandboxé sans exécution shell	Surface plus petite, pas d'exécution de commandes

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills