ellmos-filecommander-mcp 1.7.10 → 1.8.1

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to this project will be documented in this file.
 
+## [Unreleased]
+
+### Fixed
+- Correct version mismatch in banner/description display (1.7.10 → 1.8.0) and improve OCR `fc_ocr` error handling for edge cases.
+
+### Changed
+- Bump `@modelcontextprotocol/sdk` from 1.27.1 to 1.29.0.
+
+### CI
+- Add a dedicated GitHub Actions test workflow for Node.js 20, 22, and 24. The workflow runs `npm ci`, TypeScript build, Vitest, and an npm package dry-run on pushes and pull requests.
+- Lock `@emnapi/core` and `@emnapi/runtime` as dev dependencies so Linux `npm ci` resolves Vitest/Rolldown optional WASM peer dependencies deterministically.
+
+### Documentation
+- Move the `llms.txt` last-checked marker to the top of the file and normalize search phrases into a crawler-friendly fenced code block.
+- Ignore local automation protocol files via `*-protocoll.txt`.
+- Normalize `package.json` repository metadata to npm's `git+https` form.
+
+## [1.8.0] - 2026-05-31
+
+### Added
+- **Cloud-lock-safe file operations**: `fc_move`, `fc_batch_rename`, and `fc_safe_delete` now automatically fall back to copy+delete when the Windows Cloud Files filter (`cldflt.sys`) or other file locks block `rename()`. Triggered on EPERM, EACCES, EXDEV, and EBUSY errors.
+- **`fc_check_cloud_lock`** — New read-only diagnostic tool that checks whether a path is at risk of cloud-sync lock conflicts. Reports driver status, sync folder detection, and risk level. Windows-only (graceful no-op on macOS/Linux).
+- Empirical cloud-lock test (`test/empirical_cloud_lock.mjs`) using real Windows file locks to verify the fallback path.
+- 7 new unit tests for `cloudSafeRename` helper (143 total tests).
+- Full i18n (DE/EN) for all new features.
+- Total tools: 44
+
+### Changed
+- Include `server.json` in the npm package so official MCP Registry metadata ships with the published artifact.
+- Rename the official registry title from legacy "BACH FileCommander" to "ellmos FileCommander".
+- Update community workflows to `actions/stale@v10` and `actions/first-interaction@v3` with current input names.
+- Refresh README/README_de and `llms.txt` discovery notes for Glama, npm, and the ellmos MCP family.
+
 ## [1.7.10] - 2026-05-23
 
 ### Fixed

package/README.md

@@ -11,10 +11,15 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm version](https://img.shields.io/npm/v/ellmos-filecommander-mcp.svg)](https://www.npmjs.com/package/ellmos-filecommander-mcp)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+[![FileCommander tests](https://github.com/ellmos-ai/ellmos-filecommander-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/ellmos-ai/ellmos-filecommander-mcp/actions/workflows/tests.yml)
 
 A comprehensive **Model Context Protocol (MCP) server** that gives AI assistants full filesystem access, process management, interactive shell sessions, and async file search capabilities.
 
-**43 tools** in a single server - everything an AI agent needs to interact with the local system.
+**44 tools** in a single server - everything an AI agent needs to interact with the local system.
+
+**Discovery keywords:** local filesystem MCP server, safe delete MCP, Recycle Bin MCP server, process management MCP, interactive shell MCP, async file search for AI agents, Markdown to PDF MCP, OCR MCP server.
+
+**Registry status:** published on [npm](https://www.npmjs.com/package/ellmos-filecommander-mcp), listed on [Glama](https://glama.ai/mcp/servers/eyurifgg4t), and prepared for the official MCP Registry via [`server.json`](server.json). Glama currently indexes the repository metadata but still reports `tools: []`, so a reindex should be triggered after the next npm patch release.
 
 ---
 
@@ -33,6 +38,8 @@ Most filesystem MCP servers only cover basic read/write operations. FileCommande
 - **OCR** - Extract text from images (optional tesseract.js dependency)
 - **Safety Mode** - Toggle to route all deletes through Recycle Bin / Trash
 - **Markdown Export** - Convert Markdown to professional HTML/PDF with code blocks, tables, nested lists, blockquotes
+- **Cloud-Lock Safe** - Automatic copy+delete fallback when cloud sync filters (OneDrive, Dropbox, Google Drive, iCloud) block rename operations
+- **Cloud Lock Diagnosis** - Check whether a path is at risk of sync-filter conflicts before operating
 - **Cross-platform** - Works on Windows, macOS, and Linux with platform-specific optimizations
 
 ---
@@ -119,7 +126,7 @@ The server communicates via **stdio transport**. Point your MCP client to the `d
 | `fc_delete_file` | Delete a file (permanent) |
 | `fc_delete_directory` | Delete a directory (with optional recursive flag) |
 | `fc_safe_delete` | Move to Recycle Bin / Trash (recoverable!) |
-| `fc_move` | Move or rename files and directories |
+| `fc_move` | Move or rename files and directories (cloud-lock safe) |
 | `fc_copy` | Copy files and directories |
 | `fc_file_info` | Get detailed file metadata (size, dates, type) |
 | `fc_search_files` | Synchronous file search with wildcard patterns |
@@ -179,6 +186,12 @@ The server communicates via **stdio transport**. Point your MCP client to the `d
 |------|-------------|
 | `fc_ocr` | Extract text from images via tesseract.js (optional dependency) |
 
+### Cloud Sync (1 tool)
+
+| Tool | Description |
+|------|-------------|
+| `fc_check_cloud_lock` | Diagnose whether a path may be blocked by cloud sync filters (Windows) |
+
 ### System (2 tools)
 
 | Tool | Description |
@@ -193,7 +206,7 @@ The server communicates via **stdio transport**. Point your MCP client to the `d
 | `fc_md_to_html` | Markdown to standalone HTML with CSS styling (headers, code blocks, tables, nested lists, blockquotes, images, checkboxes) |
 | `fc_md_to_pdf` | Markdown to PDF via headless browser (Edge/Chrome). Falls back to HTML if no browser is available |
 
-**Total: 43 tools**
+**Total: 44 tools**
 
 ---
 
@@ -223,14 +236,15 @@ The server communicates via **stdio transport**. Point your MCP client to the `d
 | Excel / PDF support | PDF (via browser) | Yes | No |
 | HTTP transport | No | No | No |
 | Markdown to HTML/PDF export | Yes | No | No |
-| **Total tools** | **43** | ~15 | ~11 |
+| **Total tools** | **44** | ~15 | ~11 |
 | **Servers needed** | **1** | 1 | + extra for processes |
 
 **Key differentiators:**
 - Only MCP server with **recoverable delete** (Recycle Bin / Trash)
 - Only MCP server with **async background search** with pagination
 - Built-in **JSON repair**, **encoding fix**, and **duplicate detection**
-- Most comprehensive single-server solution (43 tools)
+- Only MCP server with **cloud-lock-safe file operations** (automatic copy+delete fallback)
+- Most comprehensive single-server solution (44 tools)
 - Built-in **safety mode** to prevent accidental permanent deletion
 
 ---
@@ -241,6 +255,19 @@ All tools use the `fc_` prefix (FileCommander) to avoid conflicts with other MCP
 
 ---
 
+## Discoverability
+
+FileCommander is designed to be discoverable by both people and AI agents:
+
+- `package.json` exposes the official `mcpName` (`io.github.ellmos-ai/ellmos-filecommander-mcp`) and MCP-specific npm keywords.
+- [`server.json`](server.json) follows the official MCP Registry schema and points to the npm package.
+- [`glama.json`](glama.json) provides MCP-directory metadata for Glama-compatible indexes.
+- [`llms.txt`](llms.txt) gives compact context for LLMs, agent catalogs, and documentation crawlers.
+
+Primary search terms: `ellmos-filecommander-mcp`, `FileCommander MCP`, `filesystem MCP server`, `safe delete MCP`, `async file search MCP`, `process management MCP`, `Markdown PDF MCP`.
+
+---
+
 ## Security
 
 **This server has full filesystem access with the running user's permissions.**
@@ -276,7 +303,7 @@ npm test
 
 ### Testing
 
-The project includes a comprehensive test suite with **136 tests** covering filesystem operations, format conversion, encoding repair, archive handling, duplicate detection, and more.
+The project includes a comprehensive test suite with **143 tests** covering filesystem operations, format conversion, encoding repair, archive handling, duplicate detection, and more.
 
 ```bash
 npm test              # Run all tests
@@ -285,6 +312,7 @@ npx vitest --watch    # Watch mode
 ```
 
 Tests are verified on **Windows**, **macOS**, and **Linux**.
+Pushes and pull requests run CI on Node.js **20**, **22**, and **24** with `npm ci`, TypeScript build, Vitest, and an npm package dry-run.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
 
@@ -306,7 +334,7 @@ See [CHANGELOG.md](CHANGELOG.md) for the full version history.
 
 This project was originally developed as **BACH FileCommander** (`bach-filecommander-mcp`). It has been renamed to **ellmos FileCommander** (`ellmos-filecommander-mcp`) as part of the [ellmos-ai](https://github.com/ellmos-ai) organization.
 
-The legacy package name `bach-filecommander-mcp` is deprecated. Please use [`ellmos-filecommander-mcp`](https://www.npmjs.com/package/ellmos-filecommander-mcp) instead:
+The legacy package name `bach-filecommander-mcp` is deprecated. Please use [`ellmos-filecommander-mcp`](https://www.npmjs.com/package/ellmos-filecommander-mcp) instead:
 
 ```bash
 npm uninstall -g bach-filecommander-mcp
@@ -323,10 +351,13 @@ This MCP server is part of the **[ellmos-ai](https://github.com/ellmos-ai)** eco
 
 | Server | Tools | Focus | npm |
 |--------|-------|-------|-----|
-| **[FileCommander](https://github.com/ellmos-ai/ellmos-filecommander-mcp)** | **43** | **Filesystem, process management, interactive sessions** | `ellmos-filecommander-mcp` |
-| [CodeCommander](https://github.com/ellmos-ai/ellmos-codecommander-mcp) | 17 | Code analysis, AST parsing, import management | `ellmos-codecommander-mcp` |
-| [Clatcher](https://github.com/ellmos-ai/ellmos-clatcher-mcp) | 12 | File repair, format conversion, batch operations | `ellmos-clatcher-mcp` |
-| [n8n Manager](https://github.com/ellmos-ai/n8n-manager-mcp) | 18 | n8n workflow management via AI assistants | `n8n-manager-mcp` |
+| **[FileCommander](https://github.com/ellmos-ai/ellmos-filecommander-mcp)** | **44** | **Filesystem, process management, interactive sessions, cloud-lock safe** | **[`ellmos-filecommander-mcp`](https://www.npmjs.com/package/ellmos-filecommander-mcp)** |
+| [CodeCommander](https://github.com/ellmos-ai/ellmos-codecommander-mcp) | 17 | Code analysis, AST parsing, import management | [`ellmos-codecommander-mcp`](https://www.npmjs.com/package/ellmos-codecommander-mcp) |
+| [Clatcher](https://github.com/ellmos-ai/ellmos-clatcher-mcp) | 12 | File repair, format conversion, batch operations | [`ellmos-clatcher-mcp`](https://www.npmjs.com/package/ellmos-clatcher-mcp) |
+| [n8n Manager](https://github.com/ellmos-ai/n8n-manager-mcp) | 18 | n8n workflow management via AI assistants | [`n8n-manager-mcp`](https://www.npmjs.com/package/n8n-manager-mcp) |
+| [ControlCenter](https://github.com/ellmos-ai/ellmos-controlcenter-mcp) | 10 | MCP stack discovery, profile management, control plane | [`ellmos-controlcenter-mcp`](https://www.npmjs.com/package/ellmos-controlcenter-mcp) |
+| [Homebase](https://github.com/ellmos-ai/ellmos-homebase-mcp) | 44 | LLM memory, knowledge, state, routing, and orchestration | [`ellmos-homebase-mcp`](https://www.npmjs.com/package/ellmos-homebase-mcp) (alpha) |
+| [ServerCommander](https://github.com/ellmos-ai/ellmos-servercommander-mcp) | 8 | Server operations: deploy dry-runs, mail, log analysis, health checks | [`ellmos-servercommander-mcp`](https://www.npmjs.com/package/ellmos-servercommander-mcp) (alpha) |
 
 ### AI Infrastructure
 
@@ -348,9 +379,9 @@ Our partner organization **[open-bricks](https://github.com/open-bricks)** bundl
 
 ## Haftung / Liability
 
-Dieses Projekt ist eine **unentgeltliche Open-Source-Schenkung** im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß **§ 521 BGB** auf **Vorsatz und grobe Fahrlässigkeit** beschränkt. Ergänzend gelten die Haftungsausschlüsse aus GPL-3.0 / MIT / Apache-2.0 §§ 15–16 (je nach gewählter Lizenz).
+Dieses Projekt ist eine **unentgeltliche Open-Source-Schenkung** im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß **§ 521 BGB** auf **Vorsatz und grobe Fahrlässigkeit** beschränkt. Ergänzend gilt der Haftungsausschluss der MIT-Lizenz.
 
 Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.
 
-This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code). Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.
+This project is an unpaid open-source donation. Liability is limited to intent and gross negligence (§ 521 German Civil Code). The MIT license disclaimer also applies. Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.
 

package/README_de.md

@@ -0,0 +1,375 @@
+<p align="center">
+  <img src="assets/filecommander_banner.jpg" alt="FileCommander Banner" width="700">
+</p>
+
+# ellmos FileCommander MCP Server
+
+**🇬🇧 [English Version](README.md)**
+
+*Teil der [ellmos-ai](https://github.com/ellmos-ai) Familie.*
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/ellmos-filecommander-mcp.svg)](https://www.npmjs.com/package/ellmos-filecommander-mcp)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
+[![FileCommander tests](https://github.com/ellmos-ai/ellmos-filecommander-mcp/actions/workflows/tests.yml/badge.svg)](https://github.com/ellmos-ai/ellmos-filecommander-mcp/actions/workflows/tests.yml)
+
+Ein umfassender **Model Context Protocol (MCP) Server**, der KI-Assistenten vollen Dateisystemzugriff, Prozessverwaltung, interaktive Shell-Sitzungen und asynchrone Dateisuche bietet.
+
+**44 Tools** in einem einzigen Server — alles, was ein KI-Agent für die Interaktion mit dem lokalen System braucht.
+
+**Discovery-Suchbegriffe:** lokaler Dateisystem-MCP-Server, Safe-Delete-MCP, Papierkorb-MCP-Server, Prozessverwaltungs-MCP, interaktive Shell per MCP, asynchrone Dateisuche für KI-Agenten, Markdown-zu-PDF-MCP, OCR-MCP-Server.
+
+**Registry-Status:** auf [npm](https://www.npmjs.com/package/ellmos-filecommander-mcp) veröffentlicht, auf [Glama](https://glama.ai/mcp/servers/eyurifgg4t) gelistet und über [`server.json`](server.json) für die offizielle MCP Registry vorbereitet. Glama indexiert aktuell die Repository-Metadaten, meldet aber noch `tools: []`; nach dem nächsten npm-Patchrelease sollte dort ein Reindex angestoßen werden.
+
+---
+
+## Warum FileCommander?
+
+Die meisten Dateisystem-MCP-Server decken nur grundlegende Lese-/Schreiboperationen ab. FileCommander geht weiter:
+
+- **Safe Delete** — Verschiebt Dateien in den Papierkorb (Windows) oder Trash (macOS/Linux) statt permanenter Löschung
+- **Interaktive Sitzungen** — REPLs starten und bedienen (Python, Node.js, Shells) über das MCP-Protokoll
+- **Asynchrone Suche** — Große Verzeichnisbäume im Hintergrund durchsuchen, während die KI weiterarbeitet
+- **Prozessverwaltung** — Systemprozesse auflisten, starten und beenden
+- **String Replace** — Dateien bearbeiten durch eindeutigen Stringabgleich mit Kontextvalidierung
+- **Formatkonvertierung** — Konvertierung zwischen JSON, CSV, INI, YAML, TOML, XML und TOON
+- **ZIP-Archive** — ZIP-Archive erstellen, entpacken und auflisten
+- **Prüfsummen** — SHA-256, MD5, SHA-1, SHA-512 Hashing mit Vergleichsfunktion
+- **OCR** — Texterkennung aus Bildern (optionale tesseract.js-Abhängigkeit)
+- **Safety Mode** — Umschalten, damit alle Löschvorgänge über den Papierkorb / Trash laufen
+- **Markdown-Export** — Markdown in professionelles HTML/PDF konvertieren mit Codeblöcken, Tabellen, verschachtelten Listen, Blockzitaten
+- **Cloud-Lock-sicher** — Automatischer copy+delete-Fallback wenn Cloud-Sync-Filter (OneDrive, Dropbox, Google Drive, iCloud) rename-Operationen blockieren
+- **Cloud-Lock-Diagnose** — Prüft ob ein Pfad von Sync-Filter-Konflikten betroffen sein könnte
+- **Plattformübergreifend** — Funktioniert auf Windows, macOS und Linux mit plattformspezifischen Optimierungen
+
+---
+
+## Installation
+
+### Voraussetzungen
+
+- [Node.js](https://nodejs.org/) 18 oder höher
+- npm
+
+### Option 1: Installation über NPM
+
+```bash
+npm install -g ellmos-filecommander-mcp
+```
+
+### Option 2: Installation aus dem Quellcode
+
+```bash
+git clone https://github.com/ellmos-ai/ellmos-filecommander-mcp.git
+cd ellmos-filecommander-mcp
+npm install
+npm run build
+```
+
+---
+
+## Konfiguration
+
+### Claude Desktop
+
+Zur `claude_desktop_config.json` hinzufügen:
+
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+#### Bei globaler Installation über NPM:
+
+```json
+{
+  "mcpServers": {
+    "filecommander": {
+      "command": "ellmos-filecommander"
+    }
+  }
+}
+```
+
+#### Bei Installation aus dem Quellcode:
+
+```json
+{
+  "mcpServers": {
+    "filecommander": {
+      "command": "node",
+      "args": ["/absolute/path/to/filecommander-mcp/dist/index.js"]
+    }
+  }
+}
+```
+
+Claude Desktop nach dem Speichern neu starten.
+
+### Andere MCP-Clients
+
+Der Server kommuniziert über **stdio transport**. Verweisen Sie Ihren MCP-Client auf den `dist/index.js` Einstiegspunkt oder die `ellmos-filecommander` Binary.
+
+---
+
+## Übersicht der Tools
+
+### Dateisystemoperationen (14 Tools)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_read_file` | Dateiinhalt lesen mit optionalem Zeilenlimit |
+| `fc_read_multiple_files` | Bis zu 20 Dateien in einem Aufruf lesen |
+| `fc_write_file` | Dateien schreiben/erstellen/anhängen |
+| `fc_edit_file` | Zeilenbasiertes Bearbeiten (Ersetzen, Einfügen, Löschen) |
+| `fc_str_replace` | Eindeutigen String in einer Datei ersetzen mit Kontextvalidierung |
+| `fc_list_directory` | Verzeichnisinhalt auflisten (rekursiv, konfigurierbare Tiefe) |
+| `fc_create_directory` | Verzeichnisse erstellen (einschließlich Elternverzeichnisse) |
+| `fc_delete_file` | Datei löschen (permanent) |
+| `fc_delete_directory` | Verzeichnis löschen (mit optionalem rekursivem Flag) |
+| `fc_safe_delete` | In Papierkorb / Trash verschieben (wiederherstellbar!) |
+| `fc_move` | Dateien und Verzeichnisse verschieben oder umbenennen (Cloud-Lock-sicher) |
+| `fc_copy` | Dateien und Verzeichnisse kopieren |
+| `fc_file_info` | Detaillierte Dateimetadaten abrufen (Größe, Daten, Typ) |
+| `fc_search_files` | Synchrone Dateisuche mit Wildcard-Mustern |
+
+### Asynchrone Suche (5 Tools)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_start_search` | Hintergrundsuche starten (kehrt sofort zurück) |
+| `fc_get_search_results` | Ergebnisse mit Paginierung abrufen |
+| `fc_stop_search` | Laufende Suche abbrechen |
+| `fc_list_searches` | Alle aktiven/abgeschlossenen Suchen auflisten |
+| `fc_clear_search` | Abgeschlossene Suchen aus dem Speicher entfernen |
+
+### Prozessverwaltung (4 Tools)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_execute_command` | Shell-Befehl ausführen (blockierend, mit Timeout) |
+| `fc_start_process` | Hintergrundprozess starten (nicht-blockierend) |
+| `fc_list_processes` | Laufende Systemprozesse auflisten |
+| `fc_kill_process` | Prozess nach PID oder Name beenden |
+
+### Interaktive Sitzungen (5 Tools)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_start_session` | Interaktiven Prozess starten (Python, Node, Shell...) |
+| `fc_read_output` | Sitzungsausgabe lesen |
+| `fc_send_input` | Eingabe an laufende Sitzung senden |
+| `fc_list_sessions` | Alle Sitzungen auflisten |
+| `fc_close_session` | Sitzung beenden |
+
+### Dateiwartung & Reparatur (9 Tools)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_fix_json` | Defektes JSON reparieren (BOM, nachgestellte Kommas, Kommentare, einfache Anführungszeichen) |
+| `fc_validate_json` | JSON validieren mit detaillierter Fehlerposition und Kontext |
+| `fc_cleanup_file` | BOM, NUL-Bytes, nachgestellte Leerzeichen entfernen, Zeilenenden normalisieren |
+| `fc_fix_encoding` | Mojibake / doppelt kodiertes UTF-8 reparieren (27+ Zeichenmuster) |
+| `fc_folder_diff` | Verzeichnisänderungen mit Snapshots verfolgen (neu/geändert/gelöscht) |
+| `fc_batch_rename` | Musterbasierte Massenumbenennung (Präfix/Suffix, Ersetzen, Auto-Erkennung) |
+| `fc_convert_format` | Konvertierung zwischen JSON, CSV, INI, YAML, TOML, XML und TOON |
+| `fc_detect_duplicates` | Doppelte Dateien mittels SHA-256-Hashing finden |
+| `fc_checksum` | Datei-Hashing (MD5, SHA-1, SHA-256, SHA-512) mit optionalem Vergleich |
+
+### Archiv (1 Tool)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_archive` | ZIP-Archive erstellen, entpacken und auflisten |
+
+### OCR (1 Tool)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_ocr` | Texterkennung aus Bildern über tesseract.js (optionale Abhängigkeit) |
+
+### Cloud Sync (1 Tool)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_check_cloud_lock` | Diagnose ob ein Pfad von Cloud-Sync-Filtern blockiert werden könnte (Windows) |
+
+### System (2 Tools)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_get_time` | Aktuelle Systemzeit mit Zeitzoneninformation abrufen |
+| `fc_set_safe_mode` | Safety Mode umschalten: alle Löschvorgänge über Papierkorb / Trash |
+
+### Export (2 Tools)
+
+| Tool | Beschreibung |
+|------|-------------|
+| `fc_md_to_html` | Markdown zu eigenständigem HTML mit CSS-Styling (Überschriften, Codeblöcke, Tabellen, verschachtelte Listen, Blockzitate, Bilder, Checkboxen) |
+| `fc_md_to_pdf` | Markdown zu PDF über Headless-Browser (Edge/Chrome). Fällt auf HTML zurück, wenn kein Browser verfügbar ist |
+
+**Gesamt: 44 Tools**
+
+---
+
+## Vergleich mit Alternativen
+
+| Feature | FileCommander | [Desktop Commander](https://github.com/wonderwhy-er/DesktopCommanderMCP) | [Official Filesystem](https://www.npmjs.com/package/@modelcontextprotocol/server-filesystem) |
+|---------|:---:|:---:|:---:|
+| Dateien lesen/schreiben/kopieren/verschieben | 14 Tools | Ja | Ja |
+| Safe Delete (Papierkorb) | Ja | Nein | Nein |
+| Asynchrone Hintergrundsuche | 5 Tools | Nein | Nein |
+| Interaktive Sitzungen (REPL) | 5 Tools | Ja | Nein |
+| Prozessverwaltung | 4 Tools | Ja | Nein |
+| Shell-Befehlsausführung | Ja | Ja | Nein |
+| String Replace mit Validierung | Ja | Ja | Nein |
+| Zeilenbasierte Dateibearbeitung | Ja | Nein | Nein |
+| JSON-Reparatur & Validierung | 2 Tools | Nein | Nein |
+| Encoding-Reparatur (Mojibake) | Ja | Nein | Nein |
+| Duplikaterkennung (SHA-256) | Ja | Nein | Nein |
+| Verzeichnis-Diff / Änderungsverfolgung | Ja | Nein | Nein |
+| Massenumbenennung (musterbasiert) | Ja | Nein | Nein |
+| Formatkonvertierung (JSON/CSV/INI/YAML/TOML/XML/TOON) | Ja | Nein | Nein |
+| ZIP-Archiv (erstellen/entpacken/auflisten) | Ja | Nein | Nein |
+| Datei-Prüfsummen (SHA-256/MD5) | Ja | Nein | Nein |
+| OCR (Bild zu Text) | Optional | Nein | Nein |
+| Safety Mode (Löschen → Papierkorb) | Ja | Nein | Nein |
+| Pfad-Allowlist / Sandboxing | Nein | Nein | Ja |
+| Excel / PDF-Unterstützung | PDF (über Browser) | Ja | Nein |
+| HTTP Transport | Nein | Nein | Nein |
+| Markdown zu HTML/PDF Export | Ja | Nein | Nein |
+| **Tools gesamt** | **44** | ~15 | ~11 |
+| **Benötigte Server** | **1** | 1 | + extra für Prozesse |
+
+**Hauptunterscheidungsmerkmale:**
+- Einziger MCP-Server mit **wiederherstellbarem Löschen** (Papierkorb / Trash)
+- Einziger MCP-Server mit **asynchroner Hintergrundsuche** mit Paginierung
+- Integrierte **JSON-Reparatur**, **Encoding-Korrektur** und **Duplikaterkennung**
+- Einziger MCP-Server mit **Cloud-Lock-sicheren Dateioperationen** (automatischer copy+delete-Fallback)
+- Umfassendste Einzelserver-Lösung (44 Tools)
+- Integrierter **Safety Mode** zur Vermeidung versehentlicher permanenter Löschungen
+
+---
+
+## Tool-Präfix
+
+Alle Tools verwenden das `fc_`-Präfix (FileCommander), um Konflikte mit anderen MCP-Servern zu vermeiden.
+
+---
+
+## Auffindbarkeit
+
+FileCommander ist so dokumentiert, dass Menschen, LLMs und MCP-Verzeichnisse ihn eindeutig einordnen können:
+
+- `package.json` enthält den offiziellen `mcpName` (`io.github.ellmos-ai/ellmos-filecommander-mcp`) und MCP-spezifische npm-Keywords.
+- [`server.json`](server.json) folgt dem offiziellen MCP-Registry-Schema und verweist auf das npm-Paket.
+- [`glama.json`](glama.json) liefert Metadaten für Glama-kompatible MCP-Verzeichnisse.
+- [`llms.txt`](llms.txt) bietet kompakten Kontext für LLMs, Agentenkataloge und Dokumentations-Crawler.
+
+Primäre Suchbegriffe: `ellmos-filecommander-mcp`, `FileCommander MCP`, `filesystem MCP server`, `safe delete MCP`, `async file search MCP`, `process management MCP`, `Markdown PDF MCP`.
+
+---
+
+## Sicherheit
+
+**Dieser Server hat vollen Dateisystemzugriff mit den Berechtigungen des ausführenden Benutzers.**
+
+Siehe [SECURITY.md](SECURITY.md) für detaillierte Sicherheitsinformationen und Empfehlungen.
+
+Wichtige Punkte:
+- `fc_execute_command` führt beliebige Shell-Befehle aus
+- `fc_delete_*` Tools löschen standardmäßig permanent (verwenden Sie `fc_safe_delete` oder aktivieren Sie den **Safety Mode** über `fc_set_safe_mode`, um alle Löschvorgänge über den Papierkorb / Trash zu leiten)
+- Kein eingebautes Sandboxing — die Sicherheit wird an die MCP-Client-Schicht delegiert
+- Ausschließlich für lokale Nutzung über stdio transport konzipiert
+
+---
+
+## Entwicklung
+
+```bash
+# Abhängigkeiten installieren
+npm install
+
+# Watch-Modus (automatischer Rebuild bei Änderungen)
+npm run dev
+
+# Einmaliger Build
+npm run build
+
+# Server starten
+npm start
+
+# Tests ausführen
+npm test
+```
+
+### Tests
+
+Das Projekt enthält eine umfassende Test-Suite mit **143 Tests** für Dateisystem-Operationen, Format-Konvertierung, Encoding-Reparatur, Archiv-Handling, Duplikat-Erkennung und mehr.
+
+```bash
+npm test              # Alle Tests ausführen
+npx vitest --watch    # Watch-Modus
+```
+
+Tests sind auf **Windows**, **macOS** und **Linux** verifiziert.
+Pushes und Pull Requests laufen in CI auf Node.js **20**, **22** und **24** mit `npm ci`, TypeScript-Build, Vitest und npm-Paket-Dry-Run.
+
+Siehe [CONTRIBUTING.md](CONTRIBUTING.md) für Richtlinien zur Mitwirkung.
+
+---
+
+## Änderungsprotokoll
+
+Siehe [CHANGELOG.md](CHANGELOG.md) für die vollständige Versionshistorie.
+
+---
+
+## Lizenz
+
+[MIT](LICENSE) — Lukas Geiger ([ellmos-ai](https://github.com/ellmos-ai))
+
+---
+
+## Geschichte
+
+Dieses Projekt wurde ursprünglich als **BACH FileCommander** (`bach-filecommander-mcp`) entwickelt. Es wurde im Rahmen der [ellmos-ai](https://github.com/ellmos-ai) Organisation in **ellmos FileCommander** (`ellmos-filecommander-mcp`) umbenannt.
+
+Der alte Paketname `bach-filecommander-mcp` ist veraltet. Bitte verwenden Sie stattdessen [`ellmos-filecommander-mcp`](https://www.npmjs.com/package/ellmos-filecommander-mcp):
+
+```bash
+npm uninstall -g bach-filecommander-mcp
+npm install -g ellmos-filecommander-mcp
+```
+
+---
+
+## ellmos-ai-Ökosystem
+
+Dieser MCP-Server ist Teil des **[ellmos-ai](https://github.com/ellmos-ai)**-Ökosystems: KI-Infrastruktur, MCP-Server und intelligente Werkzeuge.
+
+### MCP-Server-Familie
+
+| Server | Tools | Fokus | npm |
+|--------|-------|-------|-----|
+| **[FileCommander](https://github.com/ellmos-ai/ellmos-filecommander-mcp)** | **44** | **Dateisystem, Prozessverwaltung, interaktive Sitzungen, Cloud-Lock-sicher** | **[`ellmos-filecommander-mcp`](https://www.npmjs.com/package/ellmos-filecommander-mcp)** |
+| [CodeCommander](https://github.com/ellmos-ai/ellmos-codecommander-mcp) | 17 | Code-Analyse, AST-Parsing, Import-Verwaltung | [`ellmos-codecommander-mcp`](https://www.npmjs.com/package/ellmos-codecommander-mcp) |
+| [Clatcher](https://github.com/ellmos-ai/ellmos-clatcher-mcp) | 12 | Dateireparatur, Formatkonvertierung, Batch-Operationen | [`ellmos-clatcher-mcp`](https://www.npmjs.com/package/ellmos-clatcher-mcp) |
+| [n8n Manager](https://github.com/ellmos-ai/n8n-manager-mcp) | 18 | n8n-Workflow-Verwaltung über KI-Assistenten | [`n8n-manager-mcp`](https://www.npmjs.com/package/n8n-manager-mcp) |
+| [ControlCenter](https://github.com/ellmos-ai/ellmos-controlcenter-mcp) | 10 | MCP-Stack-Discovery, Profilverwaltung, Control Plane | [`ellmos-controlcenter-mcp`](https://www.npmjs.com/package/ellmos-controlcenter-mcp) |
+| [Homebase](https://github.com/ellmos-ai/ellmos-homebase-mcp) | 44 | LLM-Gedächtnis, Wissensbasis, Zustand, Routing und Orchestrierung | [`ellmos-homebase-mcp`](https://www.npmjs.com/package/ellmos-homebase-mcp) (alpha) |
+| [ServerCommander](https://github.com/ellmos-ai/ellmos-servercommander-mcp) | 8 | Server-Operationen: Deploy-Dry-Runs, Mail, Log-Analyse, Health-Checks | [`ellmos-servercommander-mcp`](https://www.npmjs.com/package/ellmos-servercommander-mcp) (alpha) |
+
+### KI-Infrastruktur
+
+| Projekt | Beschreibung |
+|---------|-------------|
+| [BACH](https://github.com/ellmos-ai/bach) | Textbasiertes Betriebssystem für LLMs: Handler, Tools und Skills |
+| [clutch](https://github.com/ellmos-ai/clutch) | Provider-neutrale LLM-Orchestrierung mit Auto-Routing und Budget-Tracking |
+| [rinnsal](https://github.com/ellmos-ai/rinnsal) | Leichte Agent-Memory-, Connector- und Automatisierungsinfrastruktur |
+| [ellmos-stack](https://github.com/ellmos-ai/ellmos-stack) | Self-hosted AI Research Stack |
+| [MarbleRun](https://github.com/ellmos-ai/MarbleRun) | Autonomes Agent-Chain-Framework für Claude Code |
+| [gardener](https://github.com/ellmos-ai/gardener) | Minimalistischer datenbankgetriebener LLM-OS-Prototyp |
+| [ellmos-tests](https://github.com/ellmos-ai/ellmos-tests) | Testframework für LLM-Betriebssysteme |
+
+### Desktop-Software
+
+Unsere Partnerorganisation **[open-bricks](https://github.com/open-bricks)** bündelt KI-native Desktop-Anwendungen: eine moderne Open-Source-Softwaresuite für Datei-, Dokumenten- und Entwicklerwerkzeuge.

package/dist/i18n/de.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../src/i18n/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,EAAE,EAAE,YAwdhB,CAAC"}
+{"version":3,"file":"de.d.ts","sourceRoot":"","sources":["../../src/i18n/de.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,EAAE,EAAE,YA2ehB,CAAC"}

package/dist/i18n/de.js

@@ -54,6 +54,7 @@ export const de = {
     // ==================== fc_move ====================
     fc_move: {
         moved: (source, dest) => `\u2705 Verschoben:\n  \uD83D\uDCE4 ${source}\n  \uD83D\uDCE5 ${dest}`,
+        movedViaFallback: (source, dest) => `\u2705 Verschoben (via copy+delete, Cloud-Lock umgangen):\n  \uD83D\uDCE4 ${source}\n  \uD83D\uDCE5 ${dest}`,
         moveError: (msg) => `\u274C Fehler beim Verschieben: ${msg}`,
     },
     // ==================== fc_copy ====================
@@ -421,6 +422,23 @@ export const de = {
         disabled: '\u26A0\uFE0F **Safe Mode deaktiviert.** L\u00f6schoperationen sind jetzt permanent.',
         redirected: (originalAction) => `\uD83D\uDEE1\uFE0F Safe Mode aktiv: ${originalAction} wurde in den Papierkorb umgeleitet.`,
     },
+    // ==================== fc_check_cloud_lock ====================
+    fc_check_cloud_lock: {
+        description: 'Pr\u00FCft ob ein Pfad von einem Cloud-Sync-Filter (cldflt.sys) blockiert werden k\u00F6nnte. Nur auf Windows relevant.',
+        notApplicable: '\u2139\uFE0F Cloud-Lock-Pr\u00FCfung ist nur auf Windows relevant. Auf diesem System nicht anwendbar.',
+        header: (p) => `\u2601\uFE0F **Cloud-Lock-Diagnose: ${p}**`,
+        labelDriver: 'cldflt.sys Treiber',
+        driverActive: '\uD83D\uDFE1 Aktiv (geladen)',
+        driverInactive: '\uD83D\uDFE2 Nicht geladen',
+        labelInSyncFolder: 'In Sync-Ordner',
+        notInSyncFolder: '\u2014 Nein',
+        labelRisk: 'Lock-Risiko',
+        riskHigh: '\uD83D\uDD34 Hoch \u2014 rename-Operationen k\u00F6nnen blockiert werden',
+        riskMedium: '\uD83D\uDFE1 Mittel \u2014 Teilbedingung erf\u00FCllt',
+        riskLow: '\uD83D\uDFE2 Niedrig \u2014 kein Cloud-Sync-Konflikt erwartet',
+        advice: '\uD83D\uDCA1 fc_move nutzt automatisch einen copy+delete-Fallback wenn der Cloud-Filter blockiert.',
+        checkError: (msg) => `\u274C Fehler bei Cloud-Lock-Pr\u00FCfung: ${msg}`,
+    },
     // ==================== Server ====================
     server: {
         started: '\uD83D\uDE80 BACH FileCommander MCP Server gestartet',