Mark3labs MCP Filesystem Server

🚀 File System MCP Server

A Go server implementing the Model Context Protocol (MCP) for file system operations.

🚀 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

⚠️ Important Note

This server only allows operations to be performed in the directories specified via args.

📚 Documentation

API

Resources

• file://system: File system operation interface

Tools

• read_file

  • Read the full content of a file.
  • Input: path (string).
  • Read the entire 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 a directory exists.
  • Input: path (string).
  • Create parent directories if necessary.
  • Silently succeed if the directory already exists.

• 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).
  • 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 matches 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.

• list_allowed_directories

  • List all directories that the server is allowed to access.
  • No input required.
  • Return:
    • Directories that this server can read/write.

📄 License

This MCP server is released 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.