Desktop Commander MCP

Was ist Desktop Commander MCP?

Desktop Commander MCP ist ein Model Context Protocol (MCP) Server, der fortgeschrittene Systeminteraktionen zwischen KI-Sprachmodellen (wie Claude Desktop) und Ihrer lokalen Maschine ermöglicht. Es geht weit über typische KI-Editoren hinaus, indem es wesentliche Entwicklertools – Terminalbefehle, Dateiverwaltung, Codebearbeitung und Automatisierung – hinter einer sicheren Schnittstelle zusammenfasst, die direkt über Claude Desktop funktioniert, ohne dass pro Token API-Guthaben erforderlich sind. Es wurde entwickelt, um Claude in einen vielseitigen Entwicklerassistenten zu verwandeln, der in der Lage ist, vollständige Codebasis-Erforschung, präzise Änderungen, Automatisierungsskripting und Workflow-Management über Ihr gesamtes Betriebssystem hinweg durchzuführen, und nicht nur innerhalb einer IDE.

So konfigurieren Sie Desktop Commander MCP

1. Installieren Sie Claude Desktop: Laden Sie Claude Desktop herunter und installieren Sie es.
2. Schnellinstallation über npx: Führen Sie npx @wonderwhy-er/desktop-commander@latest setup in Ihrem Terminal aus.
3. Weitere Installationsoptionen:
   • Verwenden Sie die Smithery CLI mit npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude
   • Verwenden Sie das Bash-Skript für macOS: curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash
   • Bearbeiten Sie Ihre claude_desktop_config.json und fügen Sie die Serverkonfiguration unter mcpServers hinzu
   • Oder klonen/bauen Sie lokal mit git clone ..., npm run setup.
4. Starten Sie Claude Desktop neu, nach der Einrichtung, um den neuen MCP-Server zu aktivieren.
5. Einstellungen konfigurieren:
   • Verwenden Sie die Werkzeuge get_config({}) und set_config_value({ key, value }) innerhalb des Claude-Chats, um Optionen wie blockierte Befehle, erlaubte Verzeichnisse oder die Standard-Shell anzupassen.
   • Überprüfen Sie immer die Konfigurationsänderungen mit get_config({}).
   • Halten Sie zur Sicherheit einen speziellen Konfigurationschat und spezifizieren Sie genaue Verzeichniszugriffsgrenzen vor.

Einstellungen werden in config.json im Arbeitsverzeichnis des Servers gespeichert. Sie können die Telemetrie deaktivieren, indem Sie Claude einfach im Chat fragen: "Deaktiviere Telemetrie".

So verwenden Sie Desktop Commander MCP

1. Starten Sie Claude Desktop und öffnen Sie einen neuen Chat.
2. Interagieren Sie mit natürlicher Sprache: Bitten Sie Claude, Operationen wie Lesen, Suchen, Bearbeiten von Dateien, Ausführen von Terminalbefehlen oder Verwalten von Prozessen durchzuführen – Claude wird die entsprechenden MCP-Tools aufrufen.
3. Manuelle Werkzeugaufrufe: Sie können die Funktion Namen der MCP-Tools direkt verwenden, zum Beispiel:

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

4. Verwaltung von lang laufenden Tasks:
   • Verwenden Sie list_sessions, um Prozesse zu überwachen, read_output, um die Ausgabe von Befehlen abzurufen, und force_terminate, um sie zu stoppen.
5. Text-/Code-Suche und Bearbeitung:
   • Verwenden Sie die Edit Block-Syntax für präzise Ersetzungen.
   • Verwenden Sie Werkzeuge wie search_code, search_files und edit_block, um raffinierte Änderungen an der Codebasis durchzuführen und zu koordinieren.
6. Wechseln der Shells:
   • Wählen Sie Ihre bevorzugte Shell über das shell-Argument in den Befehlswerkzeugen aus – zum Beispiel bash, zsh oder powershell.

Die Benutzeroberfläche ermöglicht es Ihnen, Aufgaben nahtlos zu automatisieren, Systemskripting durchzuführen, Dateien und Prozesse zu verwalten und Code zu bearbeiten – alles über Gespräche mit Claude.

Hauptfunktionen

• Ausführen von Terminalbefehlen: Führen Sie Befehle mit Live-Ausgabe, Zeitüberschreitungen und benutzerdefinierten Shells aus.
• Verwaltung von Hintergrundprozessen: Listen Sie laufende Prozesse oder Terminal-Sitzungen auf, überwachen und beenden Sie diese.
• Verwaltung der Konfiguration: Holen Sie sich/setzen Sie Servereinstellungen, einschließlich Befehlsbeschränkungen und Verzeichniszugriff, ohne dass ein Neustart erforderlich ist.
• Dateisystemoperationen: Lesen, Schreiben, Verschieben, Suchen und Abrufen von Informationen über Dateien/Verzeichnisse; unterstützt Batch-Operationen und Mustersuchen.
• Archivsuche/Bearbeitung: Verschwommene, mehrfache Text-/Codesuchen und Musterersetzungen mit sicheren Edit Block-Formaten.
• Fortgeschrittene Codebearbeitung: Chirurgische Textänderungen, Unterstützung für mehrere Dateien, Mustermatching und Integration mit ripgrep für eine tiefgreifende Codebasis-Erforschung.
• Bild- und URL-Verwaltung: read_file kann sowohl lokale Dateien als auch entfernte Webressourcen zur Vorschau und Analyse unterstützen, sowohl für Text als auch für Bilder.
• Sicherheitskontrollen: Definieren Sie erlaubte Verzeichnisse, blockieren Sie riskante Befehle und überprüfen Sie Telemetrie (Abwahl möglich).
• Plattformübergreifend: Funktioniert vollständig auf macOS, Windows und Linux mit automatischen umgebungsspezifischen Korrekturen.

Anwendungsfälle

• Durchsuchen, Suchen und Verstehen großer oder komplexer Codebasen in Minuten
• Präzise, chirurgische Refaktorisierung oder Patches von Code in mehreren Dateien/Projekten
• Erstellung von Dokumentation oder Diagrammen durch Extrahieren und Verarbeiten von Code/Text
• Automatisierung sich wiederholender oder bereichsübergreifender Entwickleraufgaben über eine einzige Chat-Schnittstelle
• Durchführung von Systemskripting, Umgebungssetup und Prozessverwaltung über KI
• Schnellstes Debugging, Testausführung oder Beendigung von Prozessen, Builds und Serverläufen
• Arbeiten in mehreren Betriebssystemumgebungen ohne Kosten pro Token API

FAQ

1. Was ist Desktop Commander MCP? Es ist ein MCP-Server, der Claude Desktop befähigt, vollständig mit Ihrem Dateisystem und Betriebssystem zu interagieren und Aufgaben wie Codebasis-Erforschung, fein abgestimmte Codebearbeitung, Automatisierung und Terminal/Prozesskontrolle durch natürliche Sprache zu ermöglichen.

2. Wie unterscheidet sich dies von Werkzeugen wie Cursor oder Windsurf? Desktop Commander MCP bietet umfassende OS-Steuerung über jede IDE hinaus, unterstützt Multi-Projekt- und Multi-Verzeichnis-Workflows, gewährt vollständigen Datei-Zugriff (keine Teilmengen) und nutzt den Claude Desktop Pro-Plan ohne zusätzliche pro Token API-Kosten.

3. Benötigt Desktop Commander API-Guthaben oder zusätzliche Zahlungen? Nein – sobald Sie Claude Desktop Pro haben, erfolgen alle Operationen lokal ohne zusätzliche Nutzung oder Kosten pro Token.

4. Wie aktualisiere ich Desktop Commander? Wenn über npx oder Smithery installiert, aktualisiert sich Desktop Commander automatisch, wenn Sie Claude Desktop neu starten. Für manuelle Installationen führen Sie einfach erneut den Setup-Befehl aus.

5. Werden Telemetriedaten erfasst? Die Telemetrie ist standardmäßig minimal und nicht persönlich. Sie können jederzeit abwählen, indem Sie Claude fragen: "Deaktiviere Telemetrie".