Desktop Commander (MCP server) — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Chirurgisches edit_block-Tool für diff-artige Bearbeitungen — keine vollständigen Datei-Rewrites
Terminal-Befehle mit Timeouts und Hintergrundprozess-Tracking
Konfigurierbare allowed_directories, damit Claude den Arbeitsbereich nicht verlassen kann
Dateisuche mit ripgrep-ähnlicher Geschwindigkeit
Bild-Lese-Unterstützung für Screenshots und Design-Dateien

Live-Demo

In der Praxis

desktop-commander-mcp.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren 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"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

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

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: Desktop Commander

Claude Desktop als kostenlosen Coding-Agenten ohne Cursor oder Claude Code verwenden

👤 Entwickler, die agentisches Coding ohne IDE-Abonnements wollen ⏱ ~20 min beginner

Wann einsetzen: Du hast Claude Desktop bereits und möchtest, dass es dein Repository tatsächlich bearbeitet, statt nur Snippets einzufügen.

Voraussetzungen

Claude Desktop installiert — Download von claude.ai/download
Arbeitsverzeichnis auf der Whitelist — Beim ersten Start wird abgefragt, welche Verzeichnisse Claude verwenden darf

Ablauf

Installieren und Workspace sperren

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

→ Config zeigt allowed_directories als eingeschränkt; Tool-Liste erscheint in Claude
Eine echte Änderung durchführen

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

→ Schneller ripgrep-Scan, priorisierte Liste mit Zeilennummern
Mit edit_block anwenden

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

→ Jede Bearbeitung zeigt old_string/new_string-Blöcke; sauberer git diff danach

Ergebnis: Claude Desktop schreibt nun echte Code-Änderungen in dein Repository mit der gleichen Qualität wie ein bezahlter IDE-Assistent.

Fallstricke

allowed_directories vergessen zu setzen — Claude scannt deinen Home-Ordner — ~/.claude-server-commander/config.json bearbeiten und Claude Desktop neu starten

Kombinieren mit: github · filesystem

Dev-Server starten und Ausgabe erfassen ohne den Chat zu blockieren

👤 Entwickler beim Debuggen von Multi-Prozess-Setups ⏱ ~25 min intermediate

Wann einsetzen: Du möchtest, dass Claude einen Server startet, Tests in einem anderen Terminal ausführt und gleichzeitig Logs verfolgt.

Ablauf

Server im Hintergrund starten

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

→ Prozess gestartet, PID zurückgegeben, Ausgabe-Streaming erfasst
Tests dagegen ausführen

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

→ Tests laufen unabhängig; Server streamt weiter
Logs auf Abruf inspizieren

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

→ Log-Ausschnitt mit hervorgehobenen Fehlern

Ergebnis: Multi-Prozess-Debugging-Session vollständig von Claude aus orchestriert.

Fallstricke

Hintergrundprozess läuft nach Chat-Ende weiter — kill_process-Tool verwenden wenn fertig, oder Claude Desktop neu starten

Massen-Refactoring über Hunderte von Dateien in einer Session

👤 Entwickler bei codebase-weiten Migrationen (z. B. umbenennen, deprecaten) ⏱ ~60 min intermediate

Wann einsetzen: Dein IDE-Assistent scheitert bei mehr als 50 Datei-Änderungen; du möchtest einen orchestrierten Durchlauf.

Ablauf

Änderung eingrenzen

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

→ Histogramm der Auswirkungen
Zuerst an einer Datei testen

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

→ Einzelne Datei migriert; Tests bestanden
In Batches ausrollen

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

→ Fortschrittsberichte pro Batch mit Integritätsprüfung

Ergebnis: Codebase-weite Migration mit überprüfbaren Batch-Checkpoints abgeschlossen.

Fallstricke

edit_block schlägt bei Leerzeichen-Unterschieden fehl — Such-Ersetzen-Modus für schwierigere Muster verwenden; Zeilenende-Modus prüfen

Kombinieren mit: github

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

desktop-commander-mcp + github

Lokale Bearbeitung dann PR-Erstellung

desktop-commander-mcp + filesystem

Verschiedene sandboxed Dateisystem-Zugriffe vergleichen

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen
execute_command	command: str, timeout_ms?: int	Jede Shell-Aktion — git, npm, Build-Skripte
edit_block	file_path, old_string, new_string	Chirurgische Bearbeitungen — keine vollständigen Datei-Rewrites
read_file	path	Quelldatei für Kontext lesen
write_file	path, content	Neue Datei erstellen
search_files	path, pattern	Dateien nach Name/Glob suchen
search_code	pattern, path?	Inhaltssuche über Dateien hinweg
list_processes	()	Aktive Prozesse in der Session anzeigen

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Nicht zutreffend — lokal
Tokens pro Aufruf: Variabel — große Dateien verbrauchen viele Token
Kosten in €: Kostenlos (MIT)
Tipp: search_code statt read_file verwenden, wenn nur wenige Zeilen benötigt werden

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: filesystem-read filesystem-write shell-exec

Credential-Speicherung: Keine — alles lokal

Datenabfluss: Keine — alle Aufrufe lokal

Niemals gewähren: Unrestricted root directory access

execute_command kann alles ausführen — allowed_directories eng halten
Keinen Zugriff auf ~/.ssh oder Credential-Verzeichnisse gewähren

Fehlerbehebung

Häufige Fehler und Lösungen

Zugriff verweigert bei edit_block

Das Verzeichnis zu allowed_directories in ~/.claude-server-commander/config.json hinzufügen

Prüfen: cat the config and restart Claude Desktop

Prozess gestartet aber keine Ausgabe

read_output mit der PID verwenden; Ausgabe ist gepuffert und wird nicht standardmäßig in den Chat gestreamt

edit_block meldet 'old_string not found'

Leerzeichen oder Zeilenenden weichen ab — Datei zuerst neu einlesen um exakte Bytes zu kopieren

Alternativen

Desktop Commander vs. andere

Alternative	Wann stattdessen	Kompromiss
Claude Code (CLI)	Du möchtest den Anthropic-eigenen agentischen Loop mit Planung	Claude Code ist ausgereifter erfordert aber ein eigenes Abonnement; Desktop Commander ist kostenlos
filesystem (official MCP)	Schreibgeschützter oder sandboxed Dateizugriff ohne Shell-Ausführung	Kleinere Oberfläche, keine Befehlsausführung

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen