Advertise
MCP.so
Sign In

MCP Filesystem

@gabrielmaialva33

RepositoryHomepage

Basic information

Category

Files & Storage

Last updated

License

MIT

Transports

stdio

Author

gabrielmaialva33

About MCP Filesystem

A secure Model Context Protocol (MCP) server providing filesystem access within predefined directories

#server#filesystem#mcp#mcp-server

MCP Filesystem config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-filesystem": {
      "command": "npx",
      "args": [
        "@gabrielmaialva33/mcp-filesystem",
        "/path/to/allowed/directory"
      ]
    }
  }
}

MCP Filesystem tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Mcp Filesystem?

Mcp Filesystem is a secure Model Context Protocol (MCP) server that provides controlled filesystem access for AI models. It enforces strict path validation and only allows operations within predefined directories, making it suitable for applications needing safe file read/write capabilities.

How to use Mcp Filesystem?

Install via npm (npx @gabrielmaialva33/mcp-filesystem) or clone the repository and build locally. Run the server by specifying allowed directory paths as arguments (e.g., mcp-filesystem /path/to/allowed/dir). Optionally use a JSON configuration file with --config=config.json. Integrate with Claude Desktop by adding a filesystem entry in claude_desktop_config.json.

Key features of Mcp Filesystem

  • Secure access with strict path validation
  • Read, write, edit, and move files
  • Create, list, and search directory contents
  • Recursive directory tree view
  • Secure system command execution (v0.3.1+)
  • Docker and Docker Compose support
  • Structured logging and performance metrics (v0.3.0+)
  • Configurable file size and symlink policies

Use cases of Mcp Filesystem

  • AI assistants reading and editing local project files within trusted directories
  • Automated file management and directory browsing by language models
  • Secure execution of shell commands on allowed paths for workflow automation
  • Integration with MCP‑compatible clients (e.g., Claude Desktop) for filesystem operations

Frequently asked questions

1

What is Mcp Filesystem?

It is a secure MCP server that gives AI models controlled access to files and directories, preventing unauthorized path traversal by only permitting operations inside explicitly allowed directories.

2

How do I install and run Mcp Filesystem?

You can install it globally via npm (`npm install -g @gabrielmaialva33/mcp-filesystem`) or use npx without installation. Run the server by passing one or more directory paths as arguments. A configuration file can be created with `--create-config=config.json`.

3

What tools does Mcp Filesystem provide?

It offers file operations (read, write, edit, move), directory operations (create, list, tree, search), file metadata retrieval, secure command execution, and HTTP requests (coming in v1.2.0). Performance metrics and logging are available from v0.3.0.

4

How do I configure Mcp Filesystem with Claude Desktop?

Add an entry to `claude_desktop_config.json` under `mcpServers` with the command `mcp-filesystem` (or `npx @gabrielmaialva33/mcp-filesystem`) and list allowed directories as arguments. Docker usage is also supported with volume mounts.

5

What configuration options are available?

You can set allowed directories, log level, log file path, server name/version, caching settings (enabled, maxSize, ttlMs), metrics reporting interval, and security constraints like max file size (default 10 MB) and symlink handling. See the example `config.json` in the README.

Comments

More Files & Storage MCP servers

MCP File System Server

MarcusJellinghaus

MCP Workspace Server: A secure Model Context Protocol server providing file, git, and GitHub tools for AI assistants within a sandboxed project directory.

49

Claude Document MCP Server

alejandroBallesterosC

A lightweight MCP server for processing, editing, and interacting with PDF, Word, Excel, and CSV documents.

51

drop.media

drop.media

Upload once. Find, use and share across your AI workflows. drop.media is one media library for you and every AI agent you use: files added from Claude, ChatGPT, Cursor, the terminal or the web can be found, reused and sh

Filesystem

chrisdoc

Manage your Hevy workouts, routines, folders, and exercise templates. Create and update sessions faster, organize plans, and search exercises to build workouts quickly. Stay synced with changes so your training log is always up to date.

310

HTMLvault

AI tools (Claude, ChatGPT, Gemini, Grok, etc.) generate HTML constantly, from reports to landing pages to prototypes, but there's no easy way to share it or know if anyone looked. HTMLvault turns any HTML into a clean, t

Advertise