Ellmos Filecommander MCP

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:

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.