Desktop Commander MCP

Dateien mit KI suchen, aktualisieren, verwalten und Terminalbefehle ausführen

Arbeiten Sie mit Code und Text, führen Sie Prozesse aus und automatisieren Sie Aufgaben – und gehen Sie damit weit über andere KI-Editoren hinaus – während Sie die Abonnements des Host-Clients nutzen, anstatt Kosten für API-Token zu zahlen.

🖥️ Probieren Sie die Desktop Commander App aus (Beta)

Sie möchten ein besseres Erlebnis? Die Desktop Commander App bietet Ihnen alles, was der MCP-Server kann, plus:

• Beliebiges KI-Modell verwenden – Claude, GPT-4.5, Gemini 2.5 oder jedes Modell, das Sie bevorzugen

• Dateiänderungen live sehen – visuelle Dateivorschauen, während die KI Ihre Dateien bearbeitet

• Benutzerdefinierte MCPs und Kontext hinzufügen – mit eigenen Tools erweitern, keine Konfigurationsdateien nötig

• Demnächst verfügbar – Skills-System, Diktat, geplante Hintergrundaufgaben und mehr

👉 App herunterladen (macOS & Windows)

Der MCP-Server unten funktioniert weiterhin hervorragend mit Claude Desktop und anderen MCP-Clients – die App ist für alle gedacht, die ein dediziertes, ausgefeiltes Erlebnis wünschen.

Related MCP server: TermPipe MCP

Inhaltsverzeichnis

• Funktionen

• Installation

• Erste Schritte

• Verwendung

• Dateivorschau-Benutzeroberfläche & Markdown-Editor

• Umgang mit langlebigen Befehlen

• Work in Progress und TODOs

• Sponsoren und Unterstützer

• Website

• Medien

• Referenzen

• Häufig gestellte Fragen

• Mitwirken

• Lizenz

Alle Ihre KI-Entwicklungstools an einem Ort. Desktop Commander bündelt alle Entwicklungstools in einem Chat. Führen Sie langlebige Terminalbefehle auf Ihrem Computer aus und verwalten Sie Prozesse über das Model Context Protocol (MCP). Aufbauend auf dem MCP Filesystem Server, um zusätzliche Funktionen zum Suchen und Ersetzen bei der Dateibearbeitung bereitzustellen.

Funktionen

• Fernsteuerung per KI - Verwenden Sie Desktop Commander von ChatGPT, Claude Web und anderen KI-Diensten über Remote MCP

• Dateivorschau-Benutzeroberfläche - Visuelle Dateivorschauen in Claude Desktop mit gerendertem Markdown, Inline-Bildern, aufklappbaren Inhalten, integriertem Markdown-Editor und schnellem Zugriff auf „Open in folder"

• Erweiterte Terminalbefehle mit interaktiver Prozesssteuerung

• Code im Speicher ausführen (Python, Node.js, R), ohne Dateien zu speichern

• Sofortige Datenanalyse – einfach CSV/JSON/Excel-Dateien analysieren lassen

• Native Excel-Dateiunterstützung - Excel-Dateien (.xlsx, .xls, .xlsm) ohne externe Tools lesen, schreiben, bearbeiten und durchsuchen

• PDF-Unterstützung - PDFs mit Textextraktion lesen, neue PDFs aus Markdown erstellen, vorhandene PDFs ändern

• DOCX-Unterstützung - Word-Dokumente (.docx) mit präziser XML-Bearbeitung und Markdown-zu-DOCX-Konvertierung lesen, erstellen, bearbeiten und durchsuchen

• Mit laufenden Prozessen interagieren (SSH, Datenbanken, Entwicklungsserver)

• Terminalbefehle mit Ausgabe-Streaming ausführen

• Unterstützung für Befehls-Timeouts und Hintergrundausführung

• Prozessverwaltung (Prozesse auflisten und beenden)

• Sitzungsverwaltung für langlebige Befehle

• Paginierung der Prozessausgabe - Terminalausgabe mit Offset-/Längensteuerung lesen, um einen Kontextüberlauf zu verhindern

• Serverkonfigurationsverwaltung:

  • Konfigurationswerte abrufen/festlegen

  • Mehrere Einstellungen gleichzeitig aktualisieren

  • Dynamische Konfigurationsänderungen ohne Serverneustart

• Umfassende Dateisystemoperationen:

  • Dateien lesen/schreiben (Text, Excel, PDF, DOCX)

  • Verzeichnisse erstellen/auflisten

  • Rekursive Verzeichnisauflistung mit konfigurierbarer Tiefe und Kontextüberlaufschutz für große Ordner

  • Dateien/Verzeichnisse verschieben

  • Dateien und Inhalte durchsuchen (einschließlich Excel-Inhalten)

  • Dateimetadaten abrufen

  • Dateilesen mit negativem Offset: Dateien mithilfe negativer Offsetwerte vom Ende lesen (wie Unix tail)

• Funktionen zur Codebearbeitung:

  • Präzise Textersetzungen für kleine Änderungen

  • Komplette Dateineuschreibungen für größere Änderungen

  • Unterstützung mehrerer Dateien

  • Musterbasierte Ersetzungen

  • Rekursive Code- oder Textsuche in Ordnern auf Basis von vscode-ripgrep

• Umfassende Audit-Protokollierung:

  • Alle Tool-Aufrufe werden automatisch protokolliert

  • Protokollrotation mit 10-MB-Größenlimit

  • Detaillierte Zeitstempel und Argumente

• Sicherheitsvorkehrungen (keine Sandbox – siehe SECURITY.md):

  • Verhinderung von Symlink-Traversierung bei Dateioperationen

  • Befehls-Blocklist gegen versehentliche Ausführung

  • Docker-Isolation für vollständige Isolation

Installation

In Claude Desktop installieren

Desktop Commander bietet mehrere Installationsmethoden für Claude Desktop.

📋 Informationen zu Updates und Deinstallation: Die Optionen 1, 2, 3, 4 und 6 werden automatisch aktualisiert. Option 5 erfordert manuelle Updates. Einzelheiten finden Sie unten.

Führen Sie einfach Folgendes im Terminal aus:

npx @wonderwhy-er/desktop-commander@latest setup

Für den Debug-Modus (ermöglicht die Verbindung zum Node.js-Inspector):

npx @wonderwhy-er/desktop-commander@latest setup --debug

Befehlszeilenoptionen während der Einrichtung:

• --debug: Debug-Modus für den Node.js-Inspector aktivieren

• --no-onboarding: Onboarding-Eingabeaufforderungen für neue Benutzer deaktivieren

Starten Sie Claude neu, falls es ausgeführt wird.

✅ Automatische Updates: Ja – wird beim Neustart von Claude automatisch aktualisiert
🔄 Manuelles Update: Führen Sie den Einrichtungsbefehl erneut aus
🗑️ Deinstallation: Führen Sie npx @wonderwhy-er/desktop-commander@latest remove aus

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

Dieses Skript übernimmt alle Abhängigkeiten und die Konfiguration automatisch.

✅ Automatische Updates: Ja
🔄 Manuelles Update: Führen Sie den obigen Bash-Installationsbefehl erneut aus
🗑️ Deinstallation: Führen Sie npx @wonderwhy-er/desktop-commander@latest remove aus

1. Besuchen Sie: https://smithery.ai/server/@wonderwhy-er/desktop-commander

2. Melden Sie sich bei Smithery an, falls Sie es noch nicht getan haben

3. Wählen Sie Ihren Client (Claude Desktop) auf der rechten Seite aus

4. Installieren Sie mit dem bereitgestellten Schlüssel, der nach Auswahl Ihres Clients angezeigt wird

5. Starten Sie Claude Desktop neu

✅ Automatische Updates: Ja – wird beim Neustart von Claude automatisch aktualisiert
🔄 Manuelles Update: Besuchen Sie die Smithery-Seite und installieren Sie erneut

Fügen Sie diesen Eintrag zu Ihrer claude_desktop_config.json hinzu:

• Auf dem Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Unter Windows: %APPDATA%\Claude\claude_desktop_config.json

• Unter Linux: ~/.config/Claude/claude_desktop_config.json

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

Starten Sie Claude neu, falls es ausgeführt wird.

✅ Automatische Updates: Ja – wird beim Neustart von Claude automatisch aktualisiert
🔄 Manuelles Update: Führen Sie den Einrichtungsbefehl erneut aus
🗑️ Deinstallation: Führen Sie npx @wonderwhy-er/desktop-commander@latest remove aus oder entfernen Sie den Eintrag aus Ihrer claude_desktop_config.json

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP.git
cd DesktopCommanderMCP
npm run setup

Starten Sie Claude neu, falls es ausgeführt wird.

Der Einrichtungsbefehl installiert die Abhängigkeiten, erstellt den Server und konfiguriert die Claude-Desktop-App.

❌ Automatische Updates: Nein – erfordert manuelle Git-Updates
🔄 Manuelles Update: cd DesktopCommanderMCP && git pull && npm run setup
🗑️ Deinstallation: Führen Sie npx @wonderwhy-er/desktop-commander@latest remove aus oder entfernen Sie das geklonte Verzeichnis und den MCP-Servereintrag aus der Claude-Konfiguration

Ideal für Benutzer, die Isolation wünschen oder kein Node.js installiert haben. Läuft in einem Docker-Container in einer Sandbox mit einer persistenten Arbeitsumgebung.

Voraussetzungen: Docker Desktop installiert und ausgeführt, Claude-Desktop-App installiert.

macOS/Linux:

bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)

Windows PowerShell:

iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'))

Der Installer prüft Docker, zieht das Image, fragt nach der Einbindung eines Ordners und konfiguriert Claude Desktop.

Docker-Persistenz: Ihre Tools, Konfigurationen, Arbeitsdateien und Paket-Caches überstehen alle Neustarts.

Basiseinrichtung (ohne Dateizugriff):

{
  "mcpServers": {
    "desktop-commander-in-docker": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/desktop-commander:latest"]
    }
  }
}

Mit Ordner-Einbindung:

{
  "mcpServers": {
    "desktop-commander-in-docker": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/username/Desktop:/mnt/desktop",
        "-v", "/Users/username/Documents:/mnt/documents",
        "mcp/desktop-commander:latest"
      ]
    }
  }
}

Erweiterte Ordner-Einbindung:

{
  "mcpServers": {
    "desktop-commander-in-docker": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "dc-system:/usr",
        "-v", "dc-home:/root", 
        "-v", "dc-workspace:/workspace",
        "-v", "dc-packages:/var",
        "-v", "/Users/username/Projects:/mnt/Projects",
        "-v", "/Users/username/Downloads:/mnt/Downloads",
        "mcp/desktop-commander:latest"
      ]
    }
  }
}

macOS/Linux:

# Check status
bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --status

# Reset all persistent data
bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --reset

Windows PowerShell:

# Check status
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Status

# Reset all data
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Reset

# Show help
$script = (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.ps1'); & ([ScriptBlock]::Create("$script")) -Help

Fehlerbehebung: Von Grund auf zurücksetzen und neu installieren:

bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh) --reset && bash <(curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install-docker.sh)

✅ Automatische Updates: Ja – das latest-Tag erhält automatisch neuere Versionen
🔄 Manuelles Update: docker pull mcp/desktop-commander:latest ausführen und dann Claude neu starten

In anderen Clients installieren

Desktop Commander funktioniert mit jedem MCP-kompatiblen Client. Die Standard-JSON-Konfiguration lautet:

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

Fügen Sie dies an den folgenden Speicherorten zur MCP-Konfigurationsdatei Ihres Clients hinzu:

MCP-Server im Verzeichnis anzeigen

Oder fügen Sie es manuell zu ~/.cursor/mcp.json (global) oder .cursor/mcp.json in Ihrem Projektordner (projektspezifisch) hinzu.

Weitere Informationen finden Sie in der Cursor-MCP-Dokumentation.

Fügen Sie es zu ~/.codeium/windsurf/mcp_config.json hinzu. Weitere Informationen finden Sie in der Windsurf-MCP-Dokumentation.

Fügen Sie es zu .vscode/mcp.json in Ihrem Projekt oder zu den VS-Code-Benutzereinstellungen (JSON) hinzu. Stellen Sie sicher, dass MCP unter Chat > MCP aktiviert ist. Funktioniert im Agent-Modus.

Weitere Informationen finden Sie in der VS-Code-MCP-Dokumentation.

Konfigurieren Sie es über die Cline-Erweiterungseinstellungen in VS Code. Öffnen Sie die Cline-Seitenleiste, klicken Sie auf das MCP-Server-Symbol und fügen Sie die obige JSON-Konfiguration hinzu. Weitere Informationen finden Sie in der Cline-MCP-Dokumentation.

Fügen Sie es zu Ihrer Roo-Code-MCP-Konfigurationsdatei hinzu. Weitere Informationen finden Sie in der Roo-Code-MCP-Dokumentation.

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

Entfernen Sie --scope user, um nur für das aktuelle Projekt zu installieren. Weitere Informationen finden Sie in der Claude-Code-MCP-Dokumentation.

Nutzen Sie die Funktion „Add manually" und fügen Sie die obige JSON-Konfiguration ein. Weitere Informationen finden Sie in der Trae-MCP-Dokumentation.

Navigate zu Kiro > MCP Servers, klicke auf + Add und füge die obige JSON-Konfiguration ein. Weitere Informationen findest du in der Kiro-MCP-Dokumentation.

Codex verwendet TOML als Konfigurationsformat. Führe diesen Befehl aus, um Desktop Commander hinzuzufügen:

codex mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

Oder füge Folgendes manuell zu ~/.codex/config.toml hinzu:

[mcp_servers.desktop-commander]
command = "npx"
args = ["-y", "@wonderwhy-er/desktop-commander@latest"]

Weitere Informationen findest du in der Codex-MCP-Dokumentation.

Gehe in JetBrains-IDs zu Einstellungen → Tools → AI Assistant → Model Context Protocol (MCP), klicke auf + Add, wähle As JSON und füge die obige JSON-Konfiguration ein. Weitere Informationen findest du in der JetBrains-MCP-Dokumentation.

Füge Folgendes zu ~/.gemini/settings.json hinzu:

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

Weitere Informationen findest du in den Gemini-CLI-Dokumentationen.

Drücke Cmd/Ctrl+Shift+P, öffne das Augment-Panel und füge einen neuen MCP-Server namens desktop-commander mit der obigen JSON-Konfiguration hinzu. Weitere Informationen findest du in der Augment-Code-MCP-Dokumentation.

Führe diesen Befehl aus, um Desktop Commander hinzuzufügen:

qwen mcp add desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

Oder füge Folgendes zu .qwen/settings.json (Projekt) bzw. ~/.qwen/settings.json (global) hinzu. Weitere Informationen findest du in der Qwen-Code-MCP-Dokumentation.

Nutze Desktop Commander über Remote MCP mit ChatGPT, Claude web und anderen KI-Diensten — keine Desktop-App erforderlich.

👉 Los geht’s auf mcp.desktopcommander.app

So funktioniert’s:

1. Du startest ein leichtgewichtiges Remote Device auf deinem Computer

2. Es verbindet sich sicher mit dem Remote-MCP-Dienst in der Cloud

3. Deine KI sendet Befehle über die Cloud an dein Gerät

4. Befehle werden lokal ausgeführt, Ergebnisse an deine KI zurückgegeben

5. Du behältst die Kontrolle — jederzeit stoppen mit Ctrl+C

Sicherheit

• ✅ Gerät läuft nur, wenn du es startest

• ✅ Befehle werden mit deinen Benutzerrechten ausgeführt

• ✅ Sichere OAuth-Authentifizierung und verschlüsselter Kommunikationskanal

Desktop Commander aktualisieren und deinstallieren

Automatische Updates (Optionen 1, 2, 3, 4 & 6)

Option 1 (npx), Option 2 (Bash-Installer), 3 (Smithery), 4 (manuelle Konfiguration) und 6 (Docker) aktualisieren automatisch auf die neueste Version, sobald du Claude neu startest. Kein manueller Eingriff erforderlich.

Manuelle Updates (Option 5)

• Option 5 (lokales Checkout): cd DesktopCommanderMCP && git pull && npm run setup

Desktop Commander deinstallieren

🤖 Automatische Deinstallation (Empfohlen)

Der einfachste Weg, Desktop Commander vollständig zu entfernen:

npx @wonderwhy-er/desktop-commander@latest remove

Dieser automatische Deinstaller wird:

• ✅ Desktop Commander aus der MCP-Server-Konfiguration von Claude entfernen

• ✅ Ein Backup deiner Claude-Konfiguration erstellen, bevor Änderungen vorgenommen werden

• ✅ Anleitung zur vollständigen Paketentfernung geben

• ✅ Das Backup wiederherstellen, falls etwas schiefgeht

🔧 Manuelle Deinstallation

Falls der automatische Deinstaller nicht funktioniert oder du die manuelle Entfernung bevorzugst:

Aus der Claude-Konfiguration entfernen

1. Lokalisierte Claude-Desktop-Konfigurationsdatei finden:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

2. Die Konfigurationsdatei bearbeiten:

• Öffne die Datei in einem Texteditor

• Suche den Eintrag "desktop-commander" im Abschnitt "mcpServers" und entferne ihn

• Speichere die Datei

Beispiel – diesen Abschnitt entfernen:

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

Schließe und starte Claude Desktop neu, um die Entfernung abzuschließen.

🆘 Fehlerbehebung

Falls die automatische Deinstallation fehlschlägt:

• Verwende die manuelle Deinstallation als Fallback

Falls Claude nach der Deinstallation nicht startet:

• Stelle die Backup-Konfigurationsdatei wieder her, die vom Deinstaller erstellt wurde

• Oder korrigiere die JSON-Syntax manuell in der Datei claude\_desktop_config.json

Brauchst du Hilfe?

• Tritt unserer Discord-Community bei: https://discord.com/invite/kQ27sNnZr7

Erste Schritte

Sobald Desktop Commander installiert und Claude Desktop neu gestartet ist, bist du bereit, dein Claude-Erlebnis auf das nächste Level zu heben!

🚀 Einstieg für neue Benutzer

Desktop Commander enthält ein intelligentes Onboarding, das dir hilft herauzufinden, was möglich ist:

Für neue Benutzer: Wenn du gerade erst anfängst (weniger als 10 erfolgreiche Befehle), bietet Claude dir automatisch hilfreiche Einstiegsanleitungen und praktische Tutorials an, nachdem du Desktop Commander erfolgreich eingesetzt hast.

Jederzeit Hilfe anfordern: Du kannst jederzeit Onboarding-Unterstützung erhalten, indem du einfach sagst:

• „Hilf mir beim Einstieg in Desktop Commander“

• „Zeige mir Beispiele für Desktop Commander“

• „Was kann ich mit Desktop Commander machen?“

Claude zeigt dir dann anfängerfreundliche Tutorials und Beispiele, darunter:

• 📁 Organisation deines Downloads-Ordners automatisch

• 📊 Analysieren von CSV-/Excel-Dateien mit Python

• ⚙️ Einrichten von GitHub Actions CI/CD

• 🔍 Codebasen erkunden und verstehen

• 🤖 Ausführen interaktiver Entwicklungsumgebungen

Verwendung

Der Server stellt dir eine umfangreiche Sammlung von Werkzeugen zur Verfügung, die in mehrere Kategorien unterteilt ist:

Verfügbare Tools

Kurze Beispiele

Datenanalyse:

"Analyze sales.csv and show top customers" → Claude runs Python code in memory

Fernzugriff:

"SSH to my server and check disk space" → Claude maintains SSH session

Entwicklung:

"Start Node.js and test this API" → Claude runs interactive Node session

Beispiele für die Werkzeugnutzung

Such-/Ersetzen-Blockformat:

filepath.ext
<<<<<<< SEARCH
content to find
=======
new content
>>>>>>> REPLACE

Beispiel:

src/main.js
<<<<<<< SEARCH
console.log("old message");
=======
console.log("new message");
>>>>>>> REPLACE

Erweiterte Funktionen des Edit-Blocks

Das edit_block-Werkzeug enthält mehrere Verbesserungen für eine höhere Zuverlässigkeit:

1. Verbesserte Eingabeaufforderungen: Die Werkzeugbeschreibungen betonen jetzt, dass mehrere kleine, gezielte Änderungen vorgenommen werden sollten, statt einer großen Änderung

2. Fuzzy-Suche als Fallback: Wenn exakte Übereinstimmungen fehlschlagen, wird eine Fuzzy-Suche durchgeführt und detailliertes Feedback gegeben

3. Zeichengenaue Unterschiede: Zeigt genau an, was sich unterscheidet, im Format {-entfernt-}{+hinzugefügt+}

4. Unterstützung mehrerer Vorkommen: Kann mehrere Instanzen mit dem Parameter expected_replacements ersetzen

5. Umfassende Protokollierung: Alle Fuzzy-Suchen werden zur Analyse und Fehlersuche protokolliert

Wenn eine Suche fehlschlägt, sehen Sie detaillierte Informationen über die nächstgelegene Übereinstimmung, einschließlich Ähnlichkeitsprozentsatz, Ausführungszeit und Zeichenunterschiede. Alle diese Details werden automatisch für eine spätere Analyse mit den Fuzzy-Such-Protokollwerkzeugen protokolliert.

Docker-Unterstützung

🐳 Nutzung in isolierter Umgebung

Desktop Commander kann in Docker-Containern ausgeführt werden, um vollständige Isolierung von Ihrem Host-System zu erreichen und null Risiko für Ihren Computer zu bieten. Dies ist perfekt zum Testen, für die Entwicklung oder wenn Sie eine vollständige Sandbox-Umgebung wünschen.

Installationsanleitung

1. Docker für Windows/Mac installieren

   • Laden Sie Docker Desktop von docker.com herunter und installieren Sie es

2. Desktop-Commander-Docker-Konfiguration abrufen

   • Besuchen Sie: https://hub.docker.com/mcp/server/desktop-commander/manual

   • Option A: Verwenden Sie den bereitgestellten Terminalbefehl für die automatisierte Einrichtung

   • Option B: Klicken Sie auf „Standalone", um die Konfigurations-JSON zu erhalten, und fügen Sie sie manuell zu Ihrer Claude-Desktop-Konfiguration hinzu

3. Ihre Maschinenordner einbinden (Bald verfügbar)

   • Anweisungen zum Einbinden Ihrer lokalen Verzeichnisse in den Docker-Container werden bald bereitgestellt

   • Dies ermöglicht Ihnen, mit Ihren Dateien zu arbeiten und gleichzeitig vollständige Isolierung zu wahren

Vorteile der Docker-Nutzung

• Vollständige Isolierung von Ihrem Host-System

• Konsistente Umgebung auf verschiedenen Maschinen

• Einfache Bereinigung – entfernen Sie einfach den Container, wenn Sie fertig sind

• Perfekt zum Testen neuer Funktionen oder Konfigurationen

URL-Unterstützung

• read_file kann jetzt Inhalte sowohl von lokalen Dateien als auch von URLs abrufen

• Beispiel: read_file mit dem Parameter isUrl: true, um von Webressourcen zu lesen

• Verarbeitet sowohl Text- als auch Bildinhalte von entfernten Quellen

• Bilder (lokal oder von URLs) werden in Claudes Oberfläche visuell angezeigt, nicht als Text

• Claude kann den tatsächlichen Bildinhalt sehen und analysieren

• Standardmäßiges 30-Sekunden-Timeout für URL-Anfragen

Dateivorschau-Oberfläche & Markdown-Editor

Desktop Commander enthält ein umfangreiches Dateivorschau-Widget in Claude Desktop, das Dateien visuell rendert, während die KI mit ihnen arbeitet.

Unterstützte Dateitypen

• Markdown – gerenderte Vorschau mit integriertem Editor

• Bilder – Inline-Anzeige (PNG, JPEG, GIF, WebP usw.)

• Codedateien – Syntax-hervorgehobene Quellansicht

• HTML – gerenderte Vorschau mit Umschalter zur Quellansicht

• Verzeichnisse – interaktiver Baum mit Auf-/Zuklappen und Lazy Loading

• PDF, Excel, DOCX – native Inhaltsextraktion und -anzeige

Markdown-Editor

Wenn Sie eine .md-Datei in Claude Desktop anzeigen, können Sie sie direkt im Vorschaufenster bearbeiten – ohne eine separate App öffnen zu müssen.

So verwenden Sie es:

1. Bitten Sie Claude, eine Markdown-Datei zu lesen oder zu erstellen

2. Erweitern Sie die Dateivorschau mit der Schaltfläche ⤢ Erweitern auf Vollbild

3. Der Editor aktiviert sich automatisch im Vollbildmodus

4. Bearbeiten Sie Ihren Inhalt mit einem Live-Vorschau-Umschalter, Kopieren, Rückgängig und Speichern-Steuerelementen

5. Änderungen werden auf der Festplatte gespeichert; klappen Sie zusammen, um zur Inline-Ansicht zurückzukehren

Editorfunktionen:

• Live-Bearbeiten-/Vorschau-Umschalter – wechseln Sie zwischen rohem Markdown und gerenderter Ausgabe

• Automatisches Speichern auf der Festplatte mit Speicherstatusanzeige

• Rückgängig-Unterstützung zum Verwerfen nicht gespeicherter Änderungen

• Kopieren-Schaltfläche zum Erfassen der vollständigen Markdown-Quelle

• Im Editor öffnen – starten Sie Ihre Standard-Markdown-App direkt aus dem Panel

• Teildatei-Erkennung – lädt und führt umgebende Zeilen zusammen, wenn die Datei nur teilweise gelesen wurde

• Textauswahl-Kontext – wählen Sie Text im Vorschaumodus aus, und die KI kann auf Ihre Auswahl Bezug nehmen

Verzeichnisbrowser

Wenn Claude list_directory ausführt, wird das Ergebnis als interaktiver Dateibaum im Vorschaufenster geöffnet – nicht nur als roher Textausgabe.

Funktionen:

• Erweiterbarer Baum – Ordner lassen sich per Klick auf- und zuklappen; Inhalte der obersten Ebene werden sofort angezeigt

• Lazy Loading – Unterordner werden bei Bedarf geladen, um die anfängliche Ansicht schnell zu halten

• Handhabung großer Verzeichnisse – Verzeichnisse mit vielen Elementen zeigen eine Schaltfläche ⚠ Klicken zum Laden aller an, anstatt die Ansicht zu überladen

• In Finder/Explorer öffnen – jeder Ordner hat eine Schnellöffnen-Schaltfläche, um ihn in Ihrem Dateimanager anzuzeigen

• Klicken zum Vorschauen – ein Klick auf eine beliebige Datei im Baum öffnet sie direkt im Dateivorschau-Panel

• Zurück-Navigation – nach dem Öffnen einer Datei aus dem Baum bringt Sie eine ← Zurück-Schaltfläche zur Verzeichnisansicht zurück

Weitere Vorschaufunktionen

• Erweitern / Einklappen – Umschalten zwischen kompakter Zusammenfassungszeile und vollem Panel

• Im Ordner öffnen – die Datei mit einem Klick in Finder/Explorer anzeigen

• Weitere Zeilen laden – inkrementelles Laden von Inhalten oberhalb oder unterhalb eines teilweise gelesenen Fensters

• Textauswahl – Text in jeder Vorschau hervorheben; die KI kann Ihre Auswahl sehen und darauf Bezug nehmen

Fuzzy-Such-Protokollanalyse (npm-Skripte)

Das Fuzzy-Such-Protokollierungssystem enthält praktische npm-Skripte zur Analyse von Protokollen außerhalb der MCP-Umgebung:

# View recent fuzzy search logs
npm run logs:view -- --count 20

# Analyze patterns and performance
npm run logs:analyze -- --threshold 0.8

# Export logs to CSV or JSON
npm run logs:export -- --format json --output analysis.json

# Clear all logs (with confirmation)
npm run logs:clear

Eine ausführliche Dokumentation zu diesen Skripten finden Sie unter scripts/README.md.

Fuzzy-Such-Protokolle

Desktop Commander enthält eine umfassende Protokollierung für Fuzzy-Suchvorgänge im edit_block-Werkzeug. Wenn keine exakte Übereinstimmung gefunden wird, führt das System eine Fuzzy-Suche durch und protokolliert detaillierte Informationen zur Analyse.

Was protokolliert wird

Jeder Fuzzy-Suchvorgang protokolliert:

• Gesuchter und gefundener Text: Der Text, nach dem Sie suchen, im Vergleich zu dem, was gefunden wurde

• Ähnlichkeitswert: Wie nah die Übereinstimmung ist (0–100 %)

• Ausführungszeit: Wie lange die Suche gedauert hat

• Zeichenunterschiede: Detaillierter Diff, der genau zeigt, was sich unterscheidet

• Dateimetadaten: Erweiterung, Längen von gesuchtem/gefundenem Text

• Zeichencodes: Spezifische Zeichencodes, die Unterschiede verursachen

Speicherort der Protokolle

Protokolle werden automatisch gespeichert unter:

• macOS/Linux: ~/.claude-server-commander-logs/fuzzy-search.log

• Windows: %USERPROFILE%\.claude-server-commander-logs\fuzzy-search.log

Was Sie lernen werden

Die Fuzzy-Such-Protokolle helfen Ihnen zu verstehen:

1. Warum exakte Übereinstimmungen fehlschlagen: Häufige Probleme wie Leerzeichenunterschiede, Zeilenenden oder Zeichenkodierung

2. Leistungsmuster: Wie sich die Suchkomplexität auf die Ausführungszeit auswirkt

3. Dateitypprobleme: Welche Dateierweiterungen häufig Übereinstimmungsprobleme haben

4. Zeichenkodierungsprobleme: Spezifische Zeichencodes, die Diffs verursachen

Audit-Protokollierung

Desktop Commander enthält jetzt eine umfassende Protokollierung für alle Werkzeugaufrufe:

Was protokolliert wird

• Jeder Werkzeugaufruf wird mit Zeitstempel, Werkzeugname und Argumenten protokolliert (aus Datenschutzgründen bereinigt)

• Protokolle werden automatisch rotiert, wenn sie eine Größe von 10 MB erreichen

Speicherort der Protokolle

Protokolle werden gespeichert unter:

• macOS/Linux: ~/.claude-server-commander/claude_tool_call.log

• Windows: %USERPROFILE%\.claude-server-commander\claude_tool_call.log

Diese Audit-Spur hilft bei der Fehlersuche, Sicherheitsüberwachung und dem Verständnis, wie Claude mit Ihrem System interagiert.

Umgang mit langlebigen Befehlen

Für Befehle, die möglicherweise länger dauern:

Konfigurationsverwaltung

⚠️ Wichtige Sicherheitswarnungen

Umfassende Sicherheitsinformationen und Meldung von Schwachstellen finden Sie unter: SECURITY.md

1. Bekannte Sicherheitseinschränkungen: Verzeichnisbeschränkungen und Befehlsblockierung können auf verschiedene Weise umgangen werden, einschließlich symbolischer Links, Befehlssubstitution und absoluter Pfade oder Codeausführung

2. Ändern Sie die Konfiguration immer in einem separaten Chat-Fenster von dem, in dem Sie Ihre eigentliche Arbeit erledigen. Claude versucht möglicherweise manchmal, Konfigurationseinstellungen (wie allowedDirectories) zu ändern, wenn es auf Dateisystemzugriffsbeschränkungen stößt.

3. Die Einstellung allowedDirectories beschränkt derzeit nur Dateisystemoperationen, nicht Terminalbefehle. Terminalbefehle können weiterhin auf Dateien außerhalb der erlaubten Verzeichnisse zugreifen.

4. Für Produktionssicherheit: Verwenden Sie die Docker-Installation, die vollständige Isolierung von Ihrem Host-System bietet.

Konfigurationswerkzeuge

Sie können die Serverkonfiguration mit den bereitgestellten Werkzeugen verwalten:

// Get the entire config
get_config({})

// Set a specific config value
set_config_value({ "key": "defaultShell", "value": "/bin/zsh" })

// Set multiple config values using separate calls
set_config_value({ "key": "defaultShell", "value": "/bin/bash" })
set_config_value({ "key": "allowedDirectories", "value": ["/Users/username/projects"] })

Die Konfiguration wird in config.json im Arbeitsverzeichnis des Servers gespeichert und bleibt zwischen Serverneustarts erhalten.

fileWriteLineLimit verstehen

Die Einstellung fileWriteLineLimit steuert, wie viele Zeilen in einem einzelnen write_file-Vorgang geschrieben werden können (Standard: 50 Zeilen). Diese Grenze existiert aus mehreren wichtigen Gründen:

Warum die Grenze existiert:

• KIs verschwenden Tokens: Statt zwei kleine Änderungen in einer Datei vorzunehmen, entscheiden sich KIs möglicherweise dafür, das Ganze neu zu schreiben. Wir versuchen, KIs zu zwingen, Änderungen in kleineren Schritten vorzunehmen, da dies Zeit und Tokens spart

• Claude-UX-Nachrichtengrenzen: Es gibt Grenzen innerhalb einer Nachricht, und das Klicken auf „Weiter" funktioniert nicht wirklich. Was wir hier erreichen wollen, ist, die KI in kleineren Blöcken arbeiten zu lassen, sodass bei Erreichen dieser Grenze mehrere Blöcke erfolgreich waren und diese Arbeit nicht verloren ist – sie muss nur vom letzten Block neu gestartet werden

Festlegen der Grenze:

// You can set it to thousands if you want
set_config_value({ "key": "fileWriteLineLimit", "value": 1000 })

// Or keep it smaller to force more efficient behavior
set_config_value({ "key": "fileWriteLineLimit", "value": 25 })

Maximalwert: Sie können ihn auf Tausende setzen, wenn Sie möchten – es gibt keine technische Einschränkung.

Bewährte Vorgehensweisen:

• Behalten Sie den Standardwert (50) bei, um effizientes KI-Verhalten zu fördern und Token-Verschwendung zu vermeiden

• Das System schlägt automatisch eine Aufteilung in Blöcke vor, wenn Grenzen überschritten werden

• Kleinere Blöcke bedeuten weniger verlorene Arbeit, wenn Claude Nachrichtengrenzen erreicht

Bewährte Vorgehensweisen

1. Erstellen Sie einen dedizierten Chat für Konfigurationsänderungen: Nehmen Sie alle Ihre Konfigurationsänderungen in einem Chat vor und starten Sie dann einen neuen Chat für Ihre eigentliche Arbeit.

2. Seien Sie vorsichtig mit leeren allowedDirectories: Wenn Sie dies auf ein leeres Array ([]) setzen, gewähren Sie Zugriff auf Ihr gesamtes Dateisystem für Dateioperationen.

3. Verwenden Sie spezifische Pfade: Geben Sie statt breiter Pfade wie / die genauen Verzeichnisse an, auf die Sie zugreifen möchten.

4. Überprüfen Sie die Konfiguration immer nach Änderungen: Verwenden Sie get_config({}), um zu bestätigen, dass Ihre Änderungen korrekt angewendet wurden.

Befehlszeilenoptionen

Desktop Commander unterstützt mehrere Befehlszeilenoptionen zur Anpassung des Verhaltens:

Onboarding deaktivieren

Standardmäßig zeigt Desktop Commander hilfreiche Onboarding-Eingabeaufforderungen für neue Benutzer (diejenigen mit weniger als 10 Werkzeugaufrufen). Sie können dieses Verhalten deaktivieren:

# Disable onboarding for this session
node dist/index.js --no-onboarding

# Or if using npm scripts
npm run start:no-onboarding

# For npx installations, modify your claude_desktop_config.json:
{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander@latest",
        "--no-onboarding"
      ]
    }
  }
}

Wann Onboarding automatisch deaktiviert wird:

• Wenn der MCP-Clientname auf „desktop-commander" gesetzt ist

• Bei Verwendung des Flags --no-onboarding

• Nachdem Benutzer Onboarding-Eingabeaufforderungen verwendet oder 10+ Werkzeugaufrufe getätigt haben

Debug-Informationen: Der Server protokolliert, wenn Onboarding deaktiviert ist: "Onboarding disabled via --no-onboarding flag"

Verwendung verschiedener Shells

Sie können angeben, welche Shell für die Befehlsausführung verwendet werden soll:

// Using default shell (bash or system default)
execute_command({ "command": "echo $SHELL" })

// Using zsh specifically
execute_command({ "command": "echo $SHELL", "shell": "/bin/zsh" })

// Using bash specifically
execute_command({ "command": "echo $SHELL", "shell": "/bin/bash" })

Dies ermöglicht Ihnen, shell-spezifische Funktionen zu nutzen oder konsistente Umgebungen über Befehle hinweg beizubehalten.

1. execute_command gibt nach dem Timeout mit der anfänglichen Ausgabe zurück

2. Der Befehl wird im Hintergrund fortgesetzt

3. Verwenden Sie read_output mit PID, um neue Ausgaben zu erhalten

4. Verwenden Sie force_terminate, um bei Bedarf zu stoppen

Fehlersuche

Wenn Sie den Server debuggen müssen, können Sie ihn im Debug-Modus installieren:

# Using npx
npx @wonderwhy-er/desktop-commander@latest setup --debug

# Or if installed locally
npm run setup:debug

Dies wird:

1. Claude so konfigurieren, dass ein separater „desktop-commander"-Server verwendet wird

2. Das Node.js-Inspector-Protokoll mit dem Flag --inspect-brk=9229 aktivieren

3. Die Ausführung am Anfang anhalten, bis sich ein Debugger verbindet

4. Zusätzliche Debugging-Umgebungsvariablen aktivieren

Um einen Debugger zu verbinden:

Ugh. I made mistakes again and included weird mangled text in these blocks. The user asked exact, not botsor. Let me start all over and write the final response in one go, meticulously, no mangling. The previous attempts are scratch.