Skip to main content
Glama
enhanced-filesystem-mcp

enhanced-filesystem-mcp

by AesirKode

Enhanced Filesystem MCP Server

CI Node Version License: MIT

High-performance Model Context Protocol (MCP) server giving AI agents advanced filesystem and automation capabilities on Windows.

26 tools across file I/O, search, Git, process management, Ollama, HTTP, SSH, Windows UI automation, and more — all from a single server.


Install

Requirements: Node.js >= 22 · Windows (for windows_tool; other tools are cross-platform)

git clone https://github.com/AesirKode/enhanced-filesystem-mcp
cd enhanced-filesystem-mcp
npm install
npm run build

Connect to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "enhanced-filesystem": {
      "command": "node",
      "args": ["C:/path/to/enhanced-filesystem-mcp/dist/index.js"],
      "env": {
        "ALLOWED_DIRS": "C:/Users/you/Projects",
        "MAX_PARALLEL": "20"
      }
    }
  }
}

Related MCP server: Windows-MCP

The Toolkit (26 Tools)

File Operations

Tool

Purpose

efs_read

Read any file with caching and pagination

efs_write

Write files of any size — no chunking

efs_edit

Surgical find/replace

efs_list

Directory listing with depth and pattern filters

efs_info

File metadata: size, type, timestamps

efs_delete

Delete files or directories

efs_move

Move or rename

efs_search

Parallel file/content search

efs_batch

Atomic multi-operation execution with rollback

efs_git

Git: status, diff, log, blame, commit

Execution & Process

Tool

Purpose

efs_exec

Shell command execution

efs_python

Python with persistent sessions

process_tool

Service/GPU management + NVIDIA stats

AI & Integration

Tool

Purpose

ollama_tool

Ollama LLM: generate, chat, pull, manage models

http_tool

HTTP client with auth, retry, file download

json_tool

Deep JSON with JSONPath queries

Utilities

Tool

Purpose

archive_tool

Zip: create, extract, list, add

hash_tool

MD5 / SHA1 / SHA256 / SHA512

clipboard_tool

System clipboard read/write

download_tool

Smart downloads from CivitAI, HuggingFace, URLs

model_tool

GGUF/Safetensors inspection without loading

yaml_tool

YAML/TOML config management

diff_tool

File and directory comparison

windows_tool

Windows UI automation: keyboard, mouse, screenshots

analysis_tool

TypeScript/JS code structure analysis

ssh_tool

SSH client with SFTP


Configuration

All settings via environment variables:

Variable

Default

Description

ALLOWED_DIRS

(none)

Comma-separated allowed directories

CACHE_SIZE

100

LRU cache entries

MAX_PARALLEL

20

Max parallel operations

MODELS_DIR

D:\Models

Base path for download_tool auto-placement


Contributing

See CONTRIBUTING.md. Bug reports and feature requests welcome via GitHub Issues.

License

MIT — Aesir / David R.

Available Tools

26 tools
analysis_toolA

Code analysis tool for TypeScript/JavaScript files.

Extracts structure (classes, functions, imports) without reading the full file. Useful for understanding codebases quickly.

Operations:

  • 'summarize': Get high-level structure of a file

  • 'imports': List all imports in a file

Examples:

  1. Summarize a file: { operation: 'summarize', path: 'src/index.ts' }

  2. Check imports: { operation: 'imports', path: 'src/core/utils.ts' }

Inputs: path (required), operation (required).

archive_toolA

Zip archive operations: list contents, create from files/dirs, extract to directory, add files to existing archive.

Inputs: operation (required), path, files, output, +2 more.

clipboard_toolB

System clipboard operations: copy text, read/paste current content, check type, clear, copy file paths for Explorer, get file paths from clipboard.

Inputs: operation (required), text, files.

diff_toolA

Compare files and directories. Operations: files (line-by-line diff), dirs (structural comparison), stat (size/date metadata), quick (fast identical check). Supports unified diff format.

Inputs: path1 (required), path2 (required), operation (required), limit, +2 more.

download_toolA

Smart model downloads with resume, progress, SHA256 verification, and auto-placement. Sources: CivitAI (auto-detects type), HuggingFace, direct URLs. Operations: download, info (preview without downloading), list-paths (show all model folders).

Inputs: operation (required), url, hash, filename, +1 more.

efs_batchA

Execute multiple file operations atomically.

Features:

  • All operations succeed or all rollback

  • Automatic backups before modifications

  • Parallel execution when possible

  • Transaction support

All operations complete in a single call with automatic error handling.

Operations supported:

  • read: Read file

  • write: Create/modify file

  • edit: Find/replace in file

  • delete: Remove file

  • move: Move/rename file

  • list: List directory

Parameters:

  • operations: Array of operations to execute

  • atomic: Use transactions (all-or-nothing) (default: true)

  • parallel: Execute in parallel when safe (default: true)

Operation format: { op: 'read' | 'write' | 'edit' | 'delete' | 'move' | 'list', path: string, // op-specific fields... }

Examples:

  1. Read multiple files: { operations: [ { op: 'read', path: 'file1.txt' }, { op: 'read', path: 'file2.txt' }, { op: 'read', path: 'file3.txt' } ], parallel: true }

  2. Atomic refactoring: { operations: [ { op: 'edit', path: 'file1.js', oldText: 'oldName', newText: 'newName' }, { op: 'edit', path: 'file2.js', oldText: 'oldName', newText: 'newName' }, { op: 'move', source: 'old.js', destination: 'new.js' } ], atomic: true }

  3. Project setup: { operations: [ { op: 'write', path: 'src/index.ts', content: '...' }, { op: 'write', path: 'package.json', content: '...' }, { op: 'write', path: 'tsconfig.json', content: '...' } ] }

Inputs: operations (required), atomic, parallel.

efs_deleteA

Delete file or directory. Set recursive: true for directories. Creates automatic backup before deletion.

Inputs: path (required), recursive.

efs_editA

Surgical find/replace in a file. oldText must be unique. count: default 1, use -1 for all occurrences. Set dryRun=true to preview the change without writing. Creates automatic backup.

Inputs: path (required), newText (required), oldText (required), count, +2 more.

efs_execB

Execute a shell command and return stdout/stderr. Parameters: command (required), cwd (optional), timeout ms (default 30000).

Inputs: command (required), cwd, timeout.

efs_gitB

Git operations: status, diff, log, blame, add, commit, branch, stash. repoPath required for all operations.

Inputs: repoPath (required), operation (required), args, count, +3 more.

efs_infoA

Get file/directory metadata: size, type, line count, created/modified timestamps.

Inputs: path (required).

efs_listA

List directory contents. Supports depth control, glob pattern filter, and sort by name/size/date.

Inputs: path (required), depth, sortBy, pattern.

efs_moveA

Move or rename a file or directory. Works across directories. Creates automatic backup.

Inputs: source (required), destination (required).

efs_pythonA

Execute Python code. Supports persistent named sessions (variables kept between calls). Parameters: code (required), sessionId, cwd, timeout, restart.

Inputs: code (required), cwd, restart, timeout, +1 more.

efs_readA

Read file with caching and pagination. Supports any size, text/binary, offset/length. Excel: specify sheet/range. PDF: extracts as markdown.

Inputs: path (required), range, sheet, length, +2 more.

efs_writeA

Write file of any size — no chunking required. Mode: 'rewrite' (default) or 'append'. Invalidates cache automatically.

Inputs: path (required), content (required), mode, encoding.

hash_toolA

File hashing and verification. Operations: hash (single file), verify (against expected), compare (two files), multiple (batch), string (hash text). Algorithms: md5, sha1, sha256, sha512.

Inputs: operation (required), data, path, file1, +4 more.

http_toolA

HTTP client: GET/POST/PUT/DELETE/PATCH/HEAD. Supports JSON body, Bearer/Basic auth, custom headers, timeout, retry with backoff, file download via 'download' path param.

Inputs: url (required), method (required), auth, body, +4 more.

json_toolA

Deep JSON operations with JSONPath ($.key, $..key, $.arr[*], filter expressions). Operations: get, set, delete, merge (deep/shallow/replace), diff, flatten, unflatten, validate.

Inputs: path (required), operation (required), query, value, +6 more.

model_toolA

Inspect AI model files (Safetensors/GGUF) without loading into memory. Operations: info (metadata, tensors, quantization), list (scan directory), compare (two models), search (by name/arch).

Inputs: operation (required), path, limit, path1, +5 more.

ollama_toolA

Ollama LLM integration. Operations: list (installed models), show (model details), pull (download), delete, copy, create (from Modelfile), generate (single prompt), chat (multi-turn), embeddings, ps (loaded in memory). Config: optional host/timeout overrides.

Inputs: operation (required), model, config, prompt, +6 more.

process_toolA

Process and service manager with GPU monitoring. Operations: list (filter by name/port), gpu (NVIDIA stats), start (service or custom command), kill (by PID/name/port), status, restart, monitor, wait. Predefined services: ollama (11434), comfyui (8188), koboldcpp (5001).

Inputs: operation (required), cwd, env, pid, +7 more.

ssh_toolB

SSH client with persistent sessions. Operations: connect (host/username/password or privateKeyPath), exec (run command), upload/download (SFTP), list (remote dir), disconnect. sessionId required for all ops.

Inputs: operation (required), sessionId (required), host, port, +7 more.

windows_toolB

Windows UI automation. Keyboard: type, key (with modifiers: ctrl/alt/shift/win), hotkey (e.g. 'ctrl+c'). Mouse: click (left/right/middle, x/y coords), move, scroll. Windows: list, focus, minimize, maximize, close, active, window_info, move_window, screen_size. Other: screenshot (full or region), launch app.

Inputs: operation (required), x, y, key, +16 more.

yaml_toolB

YAML/TOML/JSON config file operations. Supports get (dot-notation query), set, delete, validate, convert between formats, merge, diff, keys, format. Auto-detects format from extension.

Inputs: operation (required), path, limit, query, +9 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 26 tools

    Disambiguation3/5

    Most tools have clearly distinct purposes, but efs_batch duplicates operations in efs_read/write/edit/delete/move/list, creating ambiguity about when to use batch versus individual tools. JSON and YAML tools overlap on JSON handling, and efs_exec/process_tool have unclear boundaries for shell versus process management.

    Naming Consistency2/5

    The efs_ prefix is used for filesystem operations but also for git, exec, and python tools, making the prefix meaningless. Other tools use a '_tool' suffix with varied noun names, mixing snake_case conventions and creating two completely different naming patterns.

    Tool Count2/5

    26 tools is excessive for a filesystem-focused server, especially since many tools (ollama, http, windows automation, ssh) are unrelated to files. The broad scope makes the set feel like a grab-bag rather than a cohesive toolset.

    Completeness3/5

    Core filesystem operations like read, write, edit, delete, move, list, and search are covered, but there is no copy tool, no chmod or symlink support, and efs_git includes only a subset of git commands. The non-filesystem tools feel bolted on and do not fill these primary domain gaps.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A lightweight MCP HTTP server giving AI assistants real tools to interact with your Windows machine, including running commands, file access, system info, web search, and browser automation.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A powerful filesystem MCP server for AI agents with extensive system access, including filesystem operations, shell execution, Windows tools, reverse engineering, code intelligence, and agent orchestration.
      1
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients to securely control and interact with a local Windows machine through 218 configurable tools for files, Git, processes, Windows UI, browser automation, WSL, Office, recovery, skills, and child MCP servers.
      11 npm
      MIT