ellmos-filecommander-mcp 1.7.7 → 1.7.9

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.7.9] - 2026-05-17
+
+### Added
+- Comprehensive test suite with 136 tests covering all 43 tools (vitest)
+- Cross-platform compatibility verified on Windows, macOS, and Linux
+- Development/Testing section in README.md and README_de.md
+
 ## [1.7.2] - 2026-02-20
 
 ### Fixed

package/README.md

@@ -1,9 +1,11 @@
 <p align="center">
-  <img src="filecommander_banner.jpg" alt="FileCommander banner" width="700">
+  <img src="assets/filecommander_banner.jpg" alt="FileCommander banner" width="700">
 </p>
 
 # ellmos FileCommander MCP Server
 
+**🇩🇪 [Deutsche Version](README_de.md)**
+
 *Part of the [ellmos-ai](https://github.com/ellmos-ai) family.*
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -151,7 +153,7 @@ The server communicates via **stdio transport**. Point your MCP client to the `d
 | `fc_list_sessions` | List all sessions |
 | `fc_close_session` | Terminate a session |
 
-### File Maintenance & Repair (8 tools)
+### File Maintenance & Repair (9 tools)
 
 | Tool | Description |
 |------|-------------|
@@ -267,8 +269,23 @@ npm run build
 
 # Start the server
 npm start
+
+# Run test suite
+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.
+
+```bash
+npm test              # Run all tests
+npx vitest run        # Same as above
+npx vitest --watch    # Watch mode
 ```
 
+Tests are verified on **Windows**, **macOS**, and **Linux**.
+
 See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
 
 ---
@@ -326,3 +343,14 @@ This MCP server is part of the **[ellmos-ai](https://github.com/ellmos-ai)** eco
 ### Desktop Software
 
 Our partner organization **[open-bricks](https://github.com/open-bricks)** bundles AI-native desktop applications — a modern, open-source software suite built for the age of AI. Categories include file management, document tools, developer utilities, and more.
+
+---
+
+## 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).
+
+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.
+

package/package.json

@@ -1,65 +1,71 @@
-{
-  "name": "ellmos-filecommander-mcp",
-  "version": "1.7.7",
-  "mcpName": "io.github.ellmos-ai/ellmos-filecommander-mcp",
-  "description": "A comprehensive MCP server providing 43 tools for filesystem operations, process management, interactive sessions, async file search, JSON repair, encoding fix, duplicate detection, OCR, ZIP archives, and Markdown export",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "ellmos-filecommander": "dist/index.js"
-  },
-  "files": [
-    "dist/",
-    "LICENSE",
-    "README.md",
-    "CHANGELOG.md",
-    "SECURITY.md",
-    "THIRD_PARTY_NOTICES.md"
-  ],
-  "scripts": {
-    "build": "node node_modules/typescript/bin/tsc",
-    "start": "node dist/index.js",
-    "dev": "tsc --watch",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "claude",
-    "filesystem",
-    "file-management",
-    "process-management",
-    "mcp-server",
-    "ai-tools",
-    "claude-desktop",
-    "bach"
-  ],
-  "author": "Lukas (BACH)",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ellmos-ai/ellmos-filecommander-mcp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ellmos-ai/ellmos-filecommander-mcp/issues"
-  },
-  "homepage": "https://github.com/ellmos-ai/ellmos-filecommander-mcp#readme",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@toon-format/toon": "^2.1.0",
-    "adm-zip": "^0.5.16",
-    "fast-xml-parser": "^5.3.6",
-    "js-yaml": "^4.1.1",
-    "smol-toml": "^1.6.0",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/adm-zip": "^0.5.7",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.11.0",
-    "typescript": "^5.3.3"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "ellmos-filecommander-mcp",
+  "version": "1.7.9",
+  "mcpName": "io.github.ellmos-ai/ellmos-filecommander-mcp",
+  "description": "A comprehensive MCP server providing 43 tools for filesystem operations, process management, interactive sessions, async file search, JSON repair, encoding fix, duplicate detection, OCR, ZIP archives, and Markdown export",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "ellmos-filecommander": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "build": "node node_modules/typescript/bin/tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "filesystem",
+    "file-management",
+    "process-management",
+    "mcp-server",
+    "ai-tools",
+    "claude-desktop",
+    "bach"
+  ],
+  "author": "Lukas (BACH)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ellmos-ai/ellmos-filecommander-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ellmos-ai/ellmos-filecommander-mcp/issues"
+  },
+  "homepage": "https://github.com/ellmos-ai/ellmos-filecommander-mcp#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "@toon-format/toon": "^2.1.0",
+    "adm-zip": "^0.5.16",
+    "fast-xml-parser": "^5.3.6",
+    "js-yaml": "^4.1.1",
+    "smol-toml": "^1.6.0",
+    "zod": "^3.23.8"
+  },
+  "overrides": {
+    "hono": "^4.12.12",
+    "@hono/node-server": "^1.19.13"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3",
+    "vitest": "^3.1.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}