MCP Filesystem Server

🚀 File System MCP Server

A server for model context protocol (MCP) file system operations implemented in Go.

🚀 Quick Start

Installation

go install github.com/mark3labs/mcp-filesystem-server

Configuration

Add the following content to claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": [
        "/Users/username/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

✨ Features

• Read/write files
• Create/list/delete directories
• Move files/directories
• Search for files
• Get file metadata
• Generate directory tree structures

⚠️ Important Note

This server only allows operations within the directories specified in args.

📚 Documentation

API

Resources

• file://system: File system operation interface

Tools

• read_file

  • Read the entire content of a file.
  • Input: path (string)
  • Read the complete file content using UTF-8 encoding.

• read_multiple_files

  • Read multiple files simultaneously.
  • Input: paths (array of strings)
  • Failed reads do not stop the entire operation.

• write_file

  • Create a new file or overwrite an existing one (use this feature with caution).
  • Input:
    • path (string): File path
    • content (string): File content

• create_directory

  • Create a new directory or ensure its existence.
  • Input: path (string)
  • Create parent directories if necessary.
  • If the directory already exists, it will succeed silently.

• list_directory

  • List directory contents with [FILE] or [DIR] prefixes.
  • Input: path (string)

• move_file

  • Move or rename files and directories.
  • Input:
    • source (string)
    • destination (string)
  • It will fail if the destination already exists.

• search_files

  • Recursively search for files/directories.
  • Input:
    • path (string): Starting directory
    • pattern (string): Search pattern
  • Case-insensitive matching.
  • Return matching items with full paths.

• get_file_info

  • Get detailed metadata of a file/directory.
  • Input: path (string)
  • Return:
    • Size
    • Creation time
    • Modification time
    • Access time
    • Type (file/directory)
    • Permissions

• tree

  • Return a hierarchical JSON representation of the directory structure.
  • Input:
    • path (string): Directory to traverse (required)
    • depth (number): Maximum depth to traverse (default: 3)
    • follow_symlinks (boolean): Whether to follow symbolic links (default: false)
  • Return formatted JSON showing the file/directory hierarchy.
  • Include file metadata (name, path, size, modification time).

• list_allowed_directories

  • List all directories that the server can access.
  • No input required.
  • Return:
    • Directories that the server can read from and write to.

📄 License

This MCP server is distributed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.