ellmos FileCommander MCP server
Filesystem MCP server: files, processes, sessions, async search, OCR, archives, safe delete.
4 stars274 downloads/wk
Reviews
Write oneNobody has reviewed ellmos FileCommander yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
ellmos FileCommander tools (46, 9 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
fc_archivefc_batch_renameRenames files by pattern: remove prefix/suffix, replace, or auto-detect. Args: - directory (string): Directory with the files - mode (string): "remove_prefix" | "remove_suffix" | "replace" | "auto_detect" - pattern (string, optional): Text to remove/replace - replacement (string, optional): Replacement text (for replace mode) - extensions (string, optional): Filter by extensions - dry_run (boolean
fc_check_cloud_lockfc_checksumfc_cleanup_fileCleans up one or more files from common problems. Args: - path (string): Path to file or directory - recursive (boolean, optional): Recursive for directories - extensions (string, optional): Filter file extensions (e.g. ".txt,.json,.py") - remove_bom (boolean): Remove UTF-8 BOM - remove_trailing_whitespace (boolean): Remove trailing whitespace - normalize_line_endings (string, optional): "lf" | "c
fc_clear_searchwrite actionRemoves a completed search from the list and frees memory. Args: - search_id (string): Search ID (or "all" for all completed)
fc_close_sessionTerminates a running session and removes it from the list. Args: - session_id (string): Session ID - force (boolean, optional): Force termination
fc_convert_formatConverts files between different formats. Args: - input_path (string): Path to source file - output_path (string): Path to target file - input_format (string): "json" | "csv" | "ini" | "yaml" | "toml" | "xml" | "toon" - output_format (string): "json" | "csv" | "ini" | "yaml" | "toml" | "xml" | "toon" - json_indent (number, optional): JSON indentation (default: 2) Supported conversions: - JSON <->
fc_copyCopies a file or directory. Args: - source (string): Source path - destination (string): Destination path - recursive (boolean): Copy directories recursively
fc_create_directorywrite actionCreates a new directory (including parent directories). Args: - path (string): Path to the new directory Returns: - Confirmation of creation
fc_delete_directorywrite actionDeletes a directory. Args: - path (string): Path to the directory - recursive (boolean): Delete non-empty directories too Warning: With recursive=true ALL contents are irreversibly deleted!
fc_delete_filewrite actionDeletes a file. Args: - path (string): Path to the file Warning: Irreversible! No recycle bin.
fc_detect_duplicatesFinds file duplicates in a directory using SHA-256 hashes. Args: - directory (string): Directory to scan - recursive (boolean): Search recursively - extensions (string, optional): Filter by extensions - min_size (number, optional): Minimum size in bytes (default: 1) - max_size (number, optional): Maximum size in bytes Returns: - Groups of duplicates with paths and sizes
fc_edit_fileEdits a file line-based: replace, insert, or delete. Args: - path (string): Path to the file - operation (string): "replace" | "insert" | "delete" - start_line (number): Start line (1-based) - end_line (number, optional): End line for replace/delete - content (string, optional): New content for replace/insert Examples: - Replace lines 5-10: operation="replace", start_line=5, end_line=10, content="
fc_execute_commandwrite actionExecutes a shell command and returns the output. Args: - command (string): Command to execute - cwd (string, optional): Working directory - timeout (number, optional): Timeout in milliseconds (default: 30000) Warning: Commands are executed with user privileges! Examples: - command: "dir" (Windows) - command: "ls -la" (Unix) - command: "python --version"
fc_file_infoShows detailed information about a file/directory. Args: - path (string): Path to the file/directory Returns: - Size, type, creation/modification date, permissions
fc_fix_encodingDetects and repairs encoding errors (mojibake, double UTF-8). Args: - path (string): Path to the file - dry_run (boolean): Only show problems - create_backup (boolean): Create backup Repairs common mojibake patterns like: - ä -> ae, ö -> oe, ü -> ue (German umlauts) - ß -> ss, € -> EUR
fc_fix_jsonAutomatically repairs common JSON errors. Args: - path (string): Path to the JSON file - dry_run (boolean, optional): Only show problems, do not repair - create_backup (boolean, optional): Create backup before repair Repairs: BOM, trailing commas, single quotes, comments, NUL bytes
fc_folder_diffCompares the current state of a directory with a saved snapshot. Args: - path (string): Path to the directory - save_snapshot (boolean): Save current state as new snapshot - extensions (string, optional): Filter file extensions Detects: New files, modified files, deleted files Snapshots are saved in %TEMP%/.fc_snapshots/
fc_get_search_resultsRetrieves results of a running or completed search. Args: - search_id (string): Search ID from fc_start_search - offset (number, optional): Start offset for pagination - limit (number, optional): Maximum number of results (default: 50) Returns: - Search status and found files
fc_get_timeReturns the current system time. Returns: - Date, time, weekday, timezone
fc_kill_processwrite actionTerminates a process by PID or name. Args: - pid (number, optional): Process ID - name (string, optional): Process name - force (boolean): Force termination Warning: May cause data loss!
fc_list_directoryLists files and subdirectories. Args: - path (string): Path to the directory - depth (number, optional): Maximum depth for recursive listing (default: 1) - show_hidden (boolean, optional): Show hidden files Returns: - Formatted list of all entries with icons
fc_list_processesLists running system processes. Args: - filter (string, optional): Filter by process name Returns: - List of processes with PID, name, memory Note: Uses 'tasklist' (Windows) or 'ps' (Unix)
fc_list_searchesLists all active and completed background searches.
fc_list_sessionsLists all active and ended sessions. Returns: - Table of all sessions with status
fc_md_to_htmlConverts Markdown to formatted HTML (printable as PDF). Args: - input_path (string): Path to Markdown file - output_path (string): Path to HTML output - title (string, optional): Document title Generates standalone HTML with CSS styling, printable as PDF via browser.
fc_md_to_pdfConverts Markdown to PDF using a headless browser (Edge/Chrome). Args: - input_path (string): Path to the Markdown file - output_path (string): Path to the PDF output - title (string, optional): Document title Uses the same Markdown parser as fc_md_to_html. Requires Edge or Chrome. Falls back to HTML if no browser is found.
fc_moveMoves or renames a file/directory. Args: - source (string): Source path - destination (string): Destination path Examples: - Rename: source="test.txt", destination="test_new.txt" - Move: source="C:\a\test.txt", destination="C:\b\test.txt"
fc_ocrfc_read_fileReads the content of a file. Args: - path (string): Full path to the file - encoding (string, optional): Character encoding (default: utf-8) - max_lines (number, optional): Maximum number of lines (0 = all) Returns: - File content as text - For binary files: Base64-encoded content Examples: - path: "C:\Users\User\test.txt" - path: "/home/user/config.json"
fc_read_multiple_filesReads multiple files at once and returns their contents. Args: - paths (array): Array of file paths - max_lines_per_file (number, optional): Max lines per file (0 = all) Returns: - Contents of all files with separators Example: paths: ["C:\config.json", "C:\readme.md"]
fc_read_outputReads the output of a running session. Args: - session_id (string): Session ID from fc_start_session - clear (boolean, optional): Clear output after reading Returns: - Collected output since start/last clear
fc_safe_deletewrite actionMoves files/directories to recycle bin instead of deleting them. Args: - path (string): Path to the file/directory SAFE: Can be restored from the recycle bin! Note: Uses Windows recycle bin or creates backup on other systems.
fc_search_filesSearches files by name/pattern in a directory. Args: - directory (string): Start directory for the search - pattern (string): Search pattern (supports * and ? wildcards) - max_results (number, optional): Maximum results (default: 50) Examples: - pattern: "*.txt" - All text files - pattern: "test*" - Files starting with "test" - pattern: "*.py" - All Python files
fc_send_inputwrite actionSends input to a running session. Args: - session_id (string): Session ID - input (string): Input to send - newline (boolean, optional): Append newline (default: true) Examples: - Python: input="print('Hello')" - Shell: input="ls -la"
fc_set_languageSet the output language for FileCommander tools
fc_set_safe_modefc_start_processStarts a process in the background (non-blocking). Args: - program (string): Program/Executable - args (array, optional): Arguments as array - cwd (string, optional): Working directory Examples: - program: "notepad.exe", args: ["test.txt"] - program: "python", args: ["script.py"] - program: "code", args: ["."] (open VS Code)
fc_start_searchStarts a background search. Claude can perform other tasks in the meantime. Args: - directory (string): Start directory - pattern (string): Search pattern (wildcards: * and ?) Returns: - Search ID for fc_get_search_results, fc_stop_search Example: Start search: fc_start_search("C:\Users", "*.pdf") Get results later: fc_get_search_results(search_id)
fc_start_sessionStarts an interactive process as a session (for fc_read_output and fc_send_input). Args: - command (string): Command/Program - args (array, optional): Arguments - cwd (string, optional): Working directory Returns: - Session ID for further interaction Examples: - Python REPL: command="python" - Node REPL: command="node" - PowerShell: command="powershell"
fc_stop_searchStops a running background search. Args: - search_id (string): Search ID
fc_str_replaceReplaces a unique string in a file with another. Args: - path (string): Path to the file - old_str (string): String to replace (must occur exactly once) - new_str (string): New string (empty = delete) Returns: - Confirmation with context IMPORTANT: old_str must occur EXACTLY once in the file! An error is returned for 0 or >1 occurrences. Examples: - Rename function: old_str="def old_name", new_str
fc_validate_jsonValidates a JSON file and shows detailed error information. Args: - path (string): Path to the JSON file Returns: - Validation status with line/column on errors
fc_web_fetchfc_write_filewrite actionWrites content to a file. Creates the file if it does not exist. Args: - path (string): Full path to the file - content (string): Content to write - append (boolean, optional): Append to file instead of overwriting - create_dirs (boolean, optional): Create missing directories Returns: - Confirmation with file size Warning: Overwrites existing files without warning when append=false!
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan20 source files scanned13/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (1)
- highShell command built from a string (injection risk)
exec.shell-concatdist/index.js: … try { const result = execSync(`which ${cmd}`, { encoding: 'utf-8' }).trim(); …
What the publisher says
From the ellmos FileCommander repository's README, as published. We do not edit it. Read it on GitHub
ellmos FileCommander MCP Server
🇩🇪 Deutsche Version
Part of the ellmos-ai family.
-brightgreen.svg)
Quick Navigation:
1. Overview | 2. System Architecture | 3. End-to-End Execution Lifecycle | 4. Core Capabilities & Safety Invariants | 5. Target Personas & Discoverability | 6. Installation & Prerequisites | 7. Configuration & Client Setup | 8. Tools Overview (50 Tools) | 9. Comparative Matrix & Alternatives | 10. Tool Prefix & Naming Convention | 11. Governance & Runtime Invariants | 12. Security Architecture & Tool Risks | 13. Testing, Quality Gates & Verification | 14. Changelog & Versioning | 15. Level 1 SBOM & Third-Party Licenses | 16. History & Evolution | 17. ellmos-ai Ecosystem & Partner Matrix | 18. Statutory Notice (§ 521 BGB) & Liability Disclaimer
| Direct References: 🛡️ Security Policy • ⚖️ Third-Party Licenses • 📜 Marketing Log • 🤖 LLM Context (llms.txt) • 📋 Canonical Notice |
A comprehensive Model Context Protocol (MCP) server that gives AI assistants full filesystem access, bounded multi-file content search, process management, interactive shell sessions, and async filename search capabilities.
50 tools in a single server - everything an AI agent needs to interact with the local system.
Discovery keywords: local filesystem MCP server, multi-file content search MCP, safe delete MCP, Recycle Bin MCP server, process management MCP, interactive shell MCP, async file search for AI agents, cloud-lock-safe file operations, Markdown to PDF MCP, OCR MCP server, ZIP archive MCP.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
Runs npx -y ellmos-filecommander-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ellmos-filecommander-mcp -- npx -y ellmos-filecommander-mcp
ellmos FileCommander: common questions
- Is ellmos FileCommander MCP server safe?
- Mostly: it is graded B (72/100). Read the ellmos FileCommander safety report
- How do I install ellmos FileCommander?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does ellmos FileCommander need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is ellmos FileCommander maintained?
- The last commit was 2 days ago (2026-09-23). The latest release is v1.9.3.
- What can I use instead of ellmos FileCommander?
- Servers from other publishers that do the same job: Silica Core MCP server, Repomix MCP server and Zoteus MCP server. Compare all ellmos FileCommander alternatives.
Alternatives to ellmos FileCommander
Same job from other publishers: the closest match first, then the best rated.
- Silica CoreRetrieval over the folder the session opened: files, search, read, code_pack, write_note.not reviewedEstablishedA
- RepomixPack local or remote codebases into AI-friendly files that LLMs and coding agents can read or searchnot reviewedWidely usedA
- ZoteusZotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.not reviewedEstablishedA
- VexorA semantic search engine for files and code.not reviewedEstablishedB
- Open LibrarySearch books and authors on the Internet Archive's Open Librarynot reviewedEstablishedA