Filesystem MCP Server

by ai-yliu

Filesystem MCP Server

A Model Context Protocol (MCP) server that provides filesystem operations for Claude AI.

Features

This MCP server provides the following filesystem operations:

  1. read_file: Read complete contents of a file
    • Input: path (string)
    • Reads complete file contents with UTF-8 encoding
  2. read_multiple_files: Read multiple files simultaneously
    • Input: paths (string[])
    • Failed reads won't stop the entire operation
  3. write_file: Create new file or overwrite existing
    • Inputs:
      • path (string): File location
      • content (string): File content
  4. create_directory: Create new directory or ensure it exists
    • Input: path (string)
    • Creates parent directories if needed
    • Succeeds silently if directory exists
  5. list_directory: List directory contents with [FILE] or [DIR] prefixes
    • Input: path (string)
  6. move_file: Move or rename files and directories
    • Inputs:
      • source (string)
      • destination (string)
    • Fails if destination exists
  7. search_files: Recursively search for files/directories
    • Inputs:
      • path (string): Starting directory
      • pattern (string): Search pattern
    • Case-insensitive matching
    • Returns full paths to matches
  8. get_file_info: Get detailed file/directory metadata
    • Input: path (string)
    • Returns:
      • Size
      • Creation time
      • Modified time
      • Access time
      • Type (file/directory)
      • Permissions
  9. list_allowed_directories: List all directories the server is allowed to access
    • No input required
    • Returns directories that this server can read/write from

Security

The server only allows operations within directories specified via command-line arguments.

Installation

  1. Clone this repository
  2. Install dependencies: npm install
  3. Build the project: npm run build

Usage

Run the server with one or more allowed directories:

node build/index.js /path/to/allowed/dir1 /path/to/allowed/dir2

MCP Configuration

Add the server to your MCP configuration file:

{ "mcpServers": { "filesystem-server": { "command": "node", "args": [ "/path/to/filesystem-server/build/index.js", "/path/to/allowed/dir1", "/path/to/allowed/dir2" ], "disabled": false, "autoApprove": [] } } }

License

ISC

-
security - not tested
F
license - not found
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

An MCP server that allows Claude AI to perform filesystem operations including reading, writing, listing, moving files, and searching directories within specified allowed paths.

  1. Features
    1. Security
      1. Installation
        1. Usage
          1. MCP Configuration
            1. License

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                An MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.
                Last updated -
                1
                4
                TypeScript
                MIT License
              • A
                security
                A
                license
                A
                quality
                An MCP server that provides tools for reading, writing, and editing files on the local filesystem.
                Last updated -
                1
                1,241
                Python
                Apache 2.0
                • Apple
              • -
                security
                A
                license
                -
                quality
                An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
                Last updated -
                132
                Python
                MIT License
                • Apple
                • Linux
              • A
                security
                F
                license
                A
                quality
                A MCP server that allows searching for files in the filesystem based on path fragments, returning file metadata including name, path, size, and creation date.
                Last updated -
                1
                Python
                • Apple

              View all related MCP servers

              ID: tsjbgy73p2