MCP.so
Sign In

Filesystem MCP Server

@MCP-Mirror

Basic information

Category

Files & Storage

Transports

stdio

Author

MCP-Mirror

About Filesystem MCP Server

Mirror of

Filesystem MCP Server config

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

{
  "mcpServers": {
    "ai-yliu_filesystem-mcp-server": {
      "command": "node",
      "args": [
        "build/index.js",
        "/path/to/allowed/dir1",
        "/path/to/allowed/dir2"
      ]
    }
  }
}

Filesystem MCP Server 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.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Filesystem MCP Server?

Filesystem MCP Server is a Model Context Protocol server that provides filesystem operations for Claude AI. It allows an AI assistant to read, write, move, search, and list files and directories, but only within directories explicitly allowed by the user.

How to use Filesystem MCP Server?

Clone the repository, run npm install and npm run build, then start the server with one or more allowed directories as arguments: node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2. Add the server to your MCP configuration file with the appropriate command and args. No additional configuration keys are required.

Key features of Filesystem MCP Server

  • Read complete file contents with UTF-8 encoding
  • Read multiple files simultaneously (partial failure allowed)
  • Write new files or overwrite existing ones
  • Create directories (including parent directories)
  • List directory contents with [FILE] or [DIR] prefixes
  • Move or rename files and directories (fails if destination exists)
  • Recursively search files/directories with case‑insensitive matching
  • Retrieve detailed file metadata (size, times, type, permissions)
  • List all directories the server can access

Use cases of Filesystem MCP Server

  • Allow Claude AI to read and summarize documents from a safe sandbox folder
  • Let an assistant write notes or configuration files into a controlled workspace
  • Enable an AI to search for specific files across a project directory
  • Provide AI with directory structure information for context‑aware responses
  • Give an AI the ability to organize files (move/rename) within allowed bounds

Frequently asked questions

1

Which directories can the server access?

Only directories passed as command‑line arguments when starting the server. Operations outside these directories are denied.

2

What dependencies or runtime are required?

Node.js and npm are required. After cloning, run `npm install` and `npm run build` to compile the server.

3

Where does file data live?

All file operations happen on the local filesystem. No data is sent to external services.

4

What transport does the server use?

The server communicates via standard input/output (stdin/stdout) following the Model Context Protocol. No network transport is involved.

5

How does authentication or auto‑approval work?

The server does not define any auto‑approve tools (the `autoApprove` array is empty by default). Each tool invocation must be explicitly approved by the user through the MCP client.

Comments

More Files & Storage MCP servers