Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

ellmos FileCommander

NPM · ELLMOS-FILECOMMANDER-MCP · SCANNED AUG 3

Filesystem MCP server: files, processes, sessions, async search, OCR, archives, safe delete.

+23 this week 69 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security90
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (161 of 165), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (161 of 165), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability70
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 4710 tokens (~102/item across 46 items; 46 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
  • Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · ellmos-filecommander-mcp

# add to Claude Code
claude mcp add ellmos-ai-ellmos-filecommander-mcp -- npx -y ellmos-filecommander-mcp
# add to Codex CLI
codex mcp add ellmos-ai-ellmos-filecommander-mcp -- npx -y ellmos-filecommander-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ellmos-ai-ellmos-filecommander-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "ellmos-filecommander-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add ellmos-ai-ellmos-filecommander-mcp --command npx --arg -y --arg ellmos-filecommander-mcp
# ~/.hermes/config.yaml
mcp_servers:
  ellmos-ai-ellmos-filecommander-mcp:
    command: "npx"
    args: ["-y", "ellmos-filecommander-mcp"]
// mcp.json
{
  "mcpServers": {
    "ellmos-ai-ellmos-filecommander-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "ellmos-filecommander-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Aug 26 −2

    No change was recorded against any check on this day. Supply Chain Security went from 98 to 90. Other categories moved too: Stability & Change Management rose 4.

  • 2 Aug 26 +50
    • Provenance: unverified → fail security
    • Malware scan: unverified → pass security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • License: unverified → pass functional
    • Stability: unverified → 0.23 functional
    • Schema quality: unverified → good functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • Licence: MIT functional
  • 1 Aug 26 +16
    • Tool coverage: unverified → 100 functional
  • 31 Jul 26 −41
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 27 Jul 26 46

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 161 packages

161 packages in the resolved dependency tree · 131 deprecated · 43 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 46 exposed · ~4,710 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
fc_archive ~76

Erstellt, entpackt und listet ZIP-Archive.

NameTypeReqDescription
actionstringyesAction to perform
archive_pathstringyesPath to the ZIP archive
extract_tostringExtraction target directory (for extract action)
source_pathsarrayFiles/folders to add (for create action)

No output schema declared.

No examples provided.

fc_batch_rename ~204

Renames 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): Preview only Examples: - Remove prefix: mode="remove_prefix", pattern="backup_" - Auto-detect: mode="auto_detect" detects common prefixes

NameTypeReqDescription
directorystringyesDirectory
dry_runbooleanPreview only
extensionsstringFilter extensions
modestringyesMode
patternstringText to remove/replace
replacementstringReplacement text

No output schema declared.

No examples provided.

fc_check_cloud_lock ~49

Prüft ob ein Pfad von einem Cloud-Sync-Filter (cldflt.sys) blockiert werden könnte. Nur auf Windows relevant.

NameTypeReqDescription
pathstringyesPath to check

No output schema declared.

No examples provided.

fc_checksum ~67

Berechnet Prüfsummen (MD5/SHA1/SHA256/SHA512) für Dateien.

NameTypeReqDescription
algorithmstringHash algorithm (default: sha256)
comparestringOptional: Hash to compare against
file_pathstringyesPath to file

No output schema declared.

No examples provided.

fc_cleanup_file ~251

Cleans 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" | "crlf" | null - remove_nul_bytes (boolean): Remove NUL bytes - dry_run (boolean): Preview only Cleans: BOM, NUL bytes, trailing whitespace, line endings

NameTypeReqDescription
dry_runbooleanPreview only
extensionsstringFilter extensions (.txt,.json)
normalize_line_endingsstringLine endings
pathstringyesPath to file/directory
recursivebooleanRecursive
remove_bombooleanRemove BOM
remove_nul_bytesbooleanRemove NUL bytes
remove_trailing_whitespacebooleanTrailing whitespace

No output schema declared.

No examples provided.

fc_clear_search ~53

Removes a completed search from the list and frees memory. Args: - search_id (string): Search ID (or "all" for all completed)

NameTypeReqDescription
search_idstringyesSearch ID or 'all'

No output schema declared.

No examples provided.

fc_close_session ~62

Terminates a running session and removes it from the list. Args: - session_id (string): Session ID - force (boolean, optional): Force termination

NameTypeReqDescription
forcebooleanForce
session_idstringyesSession ID

No output schema declared.

No examples provided.

fc_convert_format ~252

Converts 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 <-> CSV (for arrays of objects) - JSON <-> INI (for flat objects/sections) - JSON <-> YAML - JSON <-> TOML - JSON <-> XML - JSON <-> TOON (hierarchical key-value format) - JSON pretty-print / minify

NameTypeReqDescription
input_formatstringyesInput format
input_pathstringyesSource file
json_indentintegerJSON indentation
output_formatstringyesOutput format
output_pathstringyesTarget file

No output schema declared.

No examples provided.

fc_copy ~71

Copies a file or directory. Args: - source (string): Source path - destination (string): Destination path - recursive (boolean): Copy directories recursively

NameTypeReqDescription
destinationstringyesDestination path
recursivebooleanCopy recursively
sourcestringyesSource path

No output schema declared.

No examples provided.

fc_create_directory ~52

Creates a new directory (including parent directories). Args: - path (string): Path to the new directory Returns: - Confirmation of creation

NameTypeReqDescription
pathstringyesPath to the new directory

No output schema declared.

No examples provided.

fc_delete_directory ~71

Deletes 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!

NameTypeReqDescription
pathstringyesPath to the directory
recursivebooleanDelete recursively

No output schema declared.

No examples provided.

fc_delete_file ~47

Deletes a file. Args: - path (string): Path to the file Warning: Irreversible! No recycle bin.

NameTypeReqDescription
pathstringyesPath to the file

No output schema declared.

No examples provided.

fc_detect_duplicates ~148

Finds 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

NameTypeReqDescription
directorystringyesDirectory
extensionsstringFilter extensions
max_sizeintegerMaximum size in bytes
min_sizeintegerMinimum size in bytes
recursivebooleanRecursive

No output schema declared.

No examples provided.

fc_edit_file ~222

Edits 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="new text" - Insert after line 3: operation="insert", start_line=3, content="new line" - Delete lines 7-9: operation="delete", start_line=7, end_line=9

NameTypeReqDescription
contentstringNew content
end_lineintegerEnd line
operationstringyesOperation
pathstringyesPath to the file
start_lineintegeryesStart line (1-based)

No output schema declared.

No examples provided.

fc_execute_command ~130

Executes 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"

NameTypeReqDescription
commandstringyesCommand to execute
cwdstringWorking directory
timeoutintegerTimeout in ms

No output schema declared.

No examples provided.

fc_file_info ~61

Shows detailed information about a file/directory. Args: - path (string): Path to the file/directory Returns: - Size, type, creation/modification date, permissions

NameTypeReqDescription
pathstringyesPath to the file/directory

No output schema declared.

No examples provided.

fc_fix_encoding ~134

Detects 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

NameTypeReqDescription
create_backupbooleanCreate backup
dry_runbooleanPreview only
pathstringyesPath to the file

No output schema declared.

No examples provided.

fc_fix_json ~110

Automatically 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

NameTypeReqDescription
create_backupbooleanCreate backup
dry_runbooleanOnly show problems
pathstringyesPath to the JSON file

No output schema declared.

No examples provided.

fc_folder_diff ~115

Compares 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/

NameTypeReqDescription
extensionsstringFilter extensions
pathstringyesPath to the directory
save_snapshotbooleanSave snapshot

No output schema declared.

No examples provided.

fc_get_search_results ~104

Retrieves 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

NameTypeReqDescription
limitintegerMax results
offsetintegerStart offset
search_idstringyesSearch ID

No output schema declared.

No examples provided.

fc_get_time ~27

Returns the current system time. Returns: - Date, time, weekday, timezone

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

fc_kill_process ~85

Terminates 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!

NameTypeReqDescription
forcebooleanForce
namestringProcess name
pidintegerProcess ID

No output schema declared.

No examples provided.

fc_list_directory ~105

Lists 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

NameTypeReqDescription
depthintegerRecursion depth
pathstringyesPath to the directory
show_hiddenbooleanShow hidden files

No output schema declared.

No examples provided.

fc_list_processes ~72

Lists 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)

NameTypeReqDescription
filterstringFilter by process name

No output schema declared.

No examples provided.

fc_list_searches ~18

Lists all active and completed background searches.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

fc_list_sessions ~27

Lists all active and ended sessions. Returns: - Table of all sessions with status

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

fc_md_to_html ~101

Converts 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.

NameTypeReqDescription
input_pathstringyesMarkdown file
output_pathstringyesHTML output
titlestringDocument title

No output schema declared.

No examples provided.

fc_md_to_pdf ~118

Converts 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.

NameTypeReqDescription
input_pathstringyesMarkdown file
output_pathstringyesPDF output
titlestringDocument title

No output schema declared.

No examples provided.

fc_move ~94

Moves 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"

NameTypeReqDescription
destinationstringyesDestination path
sourcestringyesSource path

No output schema declared.

No examples provided.

fc_ocr ~93

Extrahiert Text aus Bildern (JPG/PNG/BMP/TIFF) mittels OCR (Tesseract).

NameTypeReqDescription
file_pathstringyesPath to image (jpg/png/bmp/tiff) or PDF file
languagestringOCR language (default: eng). Use deu for German, fra for French, etc.
output_pathstringOptional: Save extracted text to file

No output schema declared.

No examples provided.

fc_read_file ~146

Reads 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"

NameTypeReqDescription
encodingstringCharacter encoding
max_linesintegerMax lines (0 = all)
pathstringyesFull path to the file

No output schema declared.

No examples provided.

fc_read_multiple_files ~107

Reads 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"]

NameTypeReqDescription
max_lines_per_fileintegerMax lines per file
pathsarrayyesArray of file paths

No output schema declared.

No examples provided.

fc_read_output ~78

Reads 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

NameTypeReqDescription
clearbooleanClear output
session_idstringyesSession ID

No output schema declared.

No examples provided.

fc_safe_delete ~72

Moves 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.

NameTypeReqDescription
pathstringyesPath to the file/directory

No output schema declared.

No examples provided.

fc_search_files ~137

Searches 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

NameTypeReqDescription
directorystringyesStart directory
max_resultsintegerMax results
patternstringyesSearch pattern with wildcards

No output schema declared.

No examples provided.

fc_send_input ~105

Sends 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"

NameTypeReqDescription
inputstringyesInput to send
newlinebooleanAppend newline
session_idstringyesSession ID

No output schema declared.

No examples provided.

fc_set_language ~27

Set the output language for FileCommander tools

NameTypeReqDescription
languagestringyesLanguage code

No output schema declared.

No examples provided.

fc_set_safe_mode ~57

Aktiviert/deaktiviert den Safe Mode. Wenn aktiv, werden alle Löschoperationen (fc_delete_file, fc_delete_directory) über den Papierkorb umgeleitet.

NameTypeReqDescription
enabledbooleanyesEnable or disable safe mode

No output schema declared.

No examples provided.

fc_start_process ~129

Starts 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)

NameTypeReqDescription
argsarrayArguments
cwdstringWorking directory
programstringyesProgram/Executable

No output schema declared.

No examples provided.

fc_start_search ~116

Starts 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)

NameTypeReqDescription
directorystringyesStart directory
patternstringyesSearch pattern with wildcards

No output schema declared.

No examples provided.

fc_start_session ~128

Starts 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"

NameTypeReqDescription
argsarrayArguments
commandstringyesCommand/Program
cwdstringWorking directory

No output schema declared.

No examples provided.

fc_stop_search ~37

Stops a running background search. Args: - search_id (string): Search ID

NameTypeReqDescription
search_idstringyesSearch ID

No output schema declared.

No examples provided.

fc_str_replace ~194

Replaces 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="def new_name" - Add import: old_str="import os", new_str="import os\nimport sys" - Delete line: old_str="# TODO: remove this\n", new_str=""

NameTypeReqDescription
new_strstringNew string (empty = delete)
old_strstringyesString to replace (must be unique)
pathstringyesPath to the file

No output schema declared.

No examples provided.

fc_validate_json ~59

Validates a JSON file and shows detailed error information. Args: - path (string): Path to the JSON file Returns: - Validation status with line/column on errors

NameTypeReqDescription
pathstringyesPath to the JSON file

No output schema declared.

No examples provided.

fc_web_fetch ~158

Ruft eine Webseite ab und gibt je nach Modus Inhalt zurück: extract (sauberer Haupttext), raw (HTTP-Body, gekürzt), links, forms oder headers. Nur lesendes Netzwerk-Tool; interne/private Ziele sind standardmäßig blockiert (allow_private zum Überschreiben).

NameTypeReqDescription
allow_privatebooleanAllow internal/private/loopback targets (turns the SSRF guard off). Default false.
modestringextract=clean main text (default), raw=HTTP body, links=all links, forms=form fields, headers=response headers
timeout_secondsintegerRequest timeout in seconds (default 20)
urlstringyesURL to fetch (http/https only)

No output schema declared.

No examples provided.

fc_write_file ~141

Writes 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!

NameTypeReqDescription
appendbooleanAppend to file
contentstringyesContent to write
create_dirsbooleanCreate missing directories
pathstringyesFull path to the file

No output schema declared.

No examples provided.