# ellmos-ai/ellmos-filecommander-mcp [Health: Active]

**Category:** 📂 File Systems  
**Repository:** https://github.com/ellmos-ai/ellmos-filecommander-mcp  
**GitHub Stars:** 4  
**npm Downloads (last month):** 1028  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ellmos-ai-ellmos-filecommander-mcp

## Description
Comprehensive local filesystem MCP server with file management, process control, interactive sessions, async search, and safe delete via Recycle Bin.

## Tools
Capabilities this server exposes over MCP:

- **fc_read_file** — Read file contents with optional line limit
- **fc_preview_file** — Inspect MIME type and size first, then explicitly request bounded inline MCP content
- **fc_read_multiple_files** — Read up to 20 files in a single call
- **fc_write_file** — Write/create/append to files
- **fc_edit_file** — Line-based editing (replace, insert, delete lines)
- **fc_str_replace** — Replace a unique string in a file with context validation
- **fc_list_directory** — List directory contents (recursive, configurable depth)
- **fc_create_directory** — Create directories (including parents)
- **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 (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
- **fc_search_content** — Read-only literal or regex search within an explicit ordered list of files, with case, context, global, and per-file limits
- **fc_start_search** — Start a background search (returns immediately)
- **fc_get_search_results** — Retrieve results with pagination
- **fc_stop_search** — Cancel a running search
- **fc_list_searches** — List all active/completed searches
- **fc_clear_search** — Remove completed searches from memory
- **fc_execute_command** — Execute a shell command (blocking, with timeout)
- **fc_start_process** — Start a background process (non-blocking)
- **fc_open_path** — Validate and open an existing local file or directory with the OS default application
- **fc_list_processes** — List running system processes
- **fc_kill_process** — Terminate a process by PID or name
- **fc_start_session** — Start an interactive process (Python, Node, shell...)
- **fc_read_output** — Read session output
- **fc_send_input** — Send input to a running session
- **fc_list_sessions** — List all sessions
- **fc_close_session** — Terminate a session
- **fc_fix_json** — Repair broken JSON (BOM, trailing commas, comments, single quotes)
- **fc_validate_json** — Validate JSON with detailed error position and context
- **fc_cleanup_file** — Remove BOM, NUL bytes, trailing whitespace, normalize line endings
- **fc_fix_encoding** — Fix Mojibake / double-encoded UTF-8 (27+ character patterns)
- **fc_folder_diff** — Track directory changes with snapshots (new/modified/deleted)
- **fc_batch_rename** — Pattern-based batch renaming (prefix/suffix, replace, auto-detect)
- **fc_convert_format** — Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats
- **fc_detect_duplicates** — Find duplicate files using SHA-256 hashing
- **fc_checksum** — File hashing (MD5, SHA-1, SHA-256, SHA-384, SHA-512) with optional compare
- **fc_archive** — Create, extract, and list ZIP archives
- **fc_ocr** — Extract text from images via tesseract.js (optional dependency)
- **fc_check_cloud_lock** — Report static cloud-sync context and target state; never claim an active lock without evidence (Windows)
- **fc_get_time** — Get current system time with timezone info
- **fc_set_safe_mode** — Toggle safe mode: all deletes go through Recycle Bin / Trash
- **fc_set_language** — Set the runtime language (`de`, `en`, `es`, `zh`, `ja`, or `ru`)
- **fc_get_language** — Read the active runtime language and all supported language codes
- **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
- **fc_web_fetch** — Fetch a web page and return content by `mode`: extract (clean main text), raw (HTTP body), links, forms, or headers. Read-only network tool; SSRF guard blocks internal/private targets by default.

## Claude Desktop Quick Installation
Install path inferred — verify against the README before running it. Uses `npx` (confidence: medium):

```json
"mcpServers": {
  "ellmos-filecommander-mcp": {
    "command": "npx",
    "args": ["-y","ellmos-filecommander-mcp"]
  }
}
```

## Documentation

## What ellmos-ai/ellmos-filecommander-mcp MCP server does

ellmos-ai/ellmos-filecommander-mcp MCP server gives an MCP-compatible AI client access to local filesystem and operating-system actions. Its tools cover file reading and writing, line-based edits, unique-string replacement, directory management, copying, moving, deletion, metadata inspection, and file search.

The server also exposes process controls and interactive sessions. An agent can execute a shell command with a timeout, start a background process, inspect or terminate processes, and open sessions for interactive programs such as Python, Node.js, or a shell. Session output can be read and input can be sent through separate tools.

Deletion has two paths: direct deletion tools can permanently remove files or directories, while `fc_safe_delete` moves an item to the platform’s Recycle Bin or Trash for recovery. The listed tools also include JSON repair for common formatting issues such as byte-order marks, trailing commas, comments, and single quotes.

## How it works

ellmos-ai/ellmos-filecommander-mcp MCP server communicates through standard stdio using JSON-RPC. Tool names use the `fc_` prefix. The README states that the package contains 50 tools, while the supplied tool list describes filesystem operations, search, process management, sessions, and JSON repair in detail.

Search can be performed synchronously with wildcard filename patterns or as a background job. Background searches return immediately and can later be queried, paginated, stopped, listed, or cleared. Content search is read-only and operates on an explicit ordered file list, with literal or regular-expression matching and configurable case, context, global, and per-file limits.

The project describes support for Windows, macOS, and Linux. Its move operation is documented as cloud-lock safe, including a copy-and-delete fallback for some sync-directory rename failures.

## Setup and configuration

The repository publishes an npm package named `ellmos-filecommander-mcp` and requires Node.js 20 or newer. A stdio MCP client can run the package with:

```bash
npx -y ellmos-filecommander-mcp
```

No API key or external service credential is identified in the supplied material. The server is intended to run locally. The README describes explicit network egress for a web-fetch capability, but that capability is not included in the supplied tool list; do not assume network access is needed for the filesystem, process, search, or session tools.

## Tools and capabilities

- Read one file or up to 20 files per call.
- Create, overwrite, append to, and edit files.
- List directories recursively with configurable depth.
- Create parent directories, copy items, and move or rename them.
- Permanently delete files or directories, or move them to recoverable Trash.
- Inspect file size, dates, and type.
- Search filenames synchronously or asynchronously.
- Search literal text or regular expressions within selected files.
- Execute commands, start background processes, and manage process IDs or names.
- Start, inspect, provide input to, list, and close interactive sessions.
- Repair malformed JSON.

## Limitations and notes

ellmos-ai/ellmos-filecommander-mcp MCP server can modify local data and execute shell commands, so client permissions and agent behavior should be considered before enabling it. Direct deletion is permanent; use `fc_safe_delete` or the project’s safety-mode behavior when recovery is important. Background searches require separate result retrieval and cleanup calls. The supplied material does not define a path allowlist, sandbox, authentication layer, or configurable environment variables, so those controls should not be assumed.

_Full upstream README: https://allmcps.com/mcp/ellmos-ai-ellmos-filecommander-mcp/readme_