RECLUDOS FILECOMMANDER MCP SERVER
==================================

Stand: 2026-01-23

WAS IST DER FILECOMMANDER?
--------------------------
Eigenstaendiger MCP-Server (Model Context Protocol) fuer:
- Dateisystem-Zugriff (Lesen, Schreiben, Suchen, Loeschen)
- Prozess-Steuerung (Befehle ausfuehren, Prozesse verwalten)
- Interaktive Sessions (Python REPL, Node, Shell)

Ersetzt Desktop Commander und Filesystem fuer recludOS/BACH-Workflows.

AKTUELLE POSITION
-----------------
%ONEDRIVE_AI_ROOT%\MCP\recludos-filecommander-mcp

(Migriert 2026-01-23 von .AI/recludos-filecommander-mcp)

TECHNOLOGIE
-----------
- Node.js 18+
- TypeScript
- MCP SDK (@modelcontextprotocol/sdk)
- Express fuer HTTP-Bridge (optional)

28 TOOLS UEBERSICHT
-------------------
Der FileCommander bietet 28 Tools mit fc_ Prefix:

DATEISYSTEM (13 Tools):
  fc_read_file             Datei lesen
  fc_read_multiple_files   Mehrere Dateien auf einmal
  fc_write_file            Schreiben/Erstellen/Anhaengen
  fc_edit_file             Zeilenbasiertes Editieren
  fc_list_directory        Verzeichnis auflisten (rekursiv)
  fc_create_directory      Verzeichnis erstellen
  fc_delete_file           Datei loeschen (unwiderruflich!)
  fc_delete_directory      Verzeichnis loeschen
  fc_safe_delete           In Papierkorb (wiederherstellbar)
  fc_move                  Verschieben/Umbenennen
  fc_copy                  Kopieren
  fc_file_info             Detaillierte Infos
  fc_search_files          Synchrone Suche

ASYNCHRONE SUCHE (5 Tools):
  fc_start_search          Hintergrund-Suche starten
  fc_get_search_results    Ergebnisse abrufen (Paginierung)
  fc_stop_search           Suche stoppen
  fc_list_searches         Alle Suchen auflisten
  fc_clear_search          Beendete Suchen entfernen

PROZESS-STEUERUNG (4 Tools):
  fc_execute_command       Shell-Befehl (blockierend)
  fc_start_process         Hintergrund-Prozess
  fc_list_processes        Systemprozesse auflisten
  fc_kill_process          Prozess beenden

INTERAKTIVE SESSIONS (5 Tools):
  fc_start_session         Python/Node/Shell Session starten
  fc_read_output           Session-Output lesen
  fc_send_input            Input an Session senden
  fc_list_sessions         Sessions auflisten
  fc_close_session         Session beenden

SYSTEM (1 Tool):
  fc_get_time              Aktuelle Systemzeit

CLAUDE INTEGRATION
------------------
Der Server wird in Claude Desktop via claude_desktop_config.json eingebunden:

  Windows: %APPDATA%\Claude\claude_desktop_config.json

  {
    "mcpServers": {
      "recludos-filecommander": {
        "command": "node",
        "args": ["C:\\...\\recludos-filecommander-mcp\\dist\\index.js"]
      }
    }
  }

BACH-BEZUG
----------
FileCommander ist die primaere Schnittstelle fuer:
- Dateisystem-Operationen in BACH-Sessions
- Tool-Ausfuehrung via fc_execute_command
- Python-Integration via fc_start_session

In BACH-Workflows werden diese Tools automatisch verwendet wenn
Claude Dateien lesen, schreiben oder Befehle ausfuehren soll.

SICHERHEIT
----------
ACHTUNG: Voller Dateisystem-Zugriff mit Benutzerrechten!

- fc_delete_* loescht unwiderruflich (nutze fc_safe_delete!)
- fc_execute_command fuehrt beliebige Shell-Befehle aus
- Sessions haben volle Benutzerrechte

VERSION
-------
Aktuell: 1.2.2 (2026-01-23)
- 28 Tools insgesamt
- Async Search, Safe Delete, Session-Management
- PowerShell-Pfad dynamisch ermittelt (BUG-010 Fix)
- Automatisches Escaping fuer & und Sonderzeichen in Pfaden

SIEHE AUCH
----------
wiki/mcp.txt         Model Context Protocol (geplant)
docs/help/tools.txt            BACH Tool-Inventar
wiki/ollama.txt      Lokaler LLM-Server
