What is Mark3labs Mcp Filesystem Server

mark3labs_mcp-filesystem-server is a Go server that implements the Model Context Protocol (MCP) for performing various filesystem operations such as reading, writing, and managing files and directories.

Use cases

Use cases include building applications that require file storage solutions, implementing backup systems, and developing tools for file management and organization.

How to use

To use mark3labs_mcp-filesystem-server, install the server using Go, and then interact with its API to perform filesystem operations. The server allows operations only within specified directories.

Key features

Key features include reading and writing files, creating, listing, and deleting directories, moving files and directories, searching for files, and retrieving file metadata.

Where to use

mark3labs_mcp-filesystem-server can be used in various fields such as software development, data management, and any application requiring filesystem manipulation and management.

Filesystem MCP Server

Go server implementing Model Context Protocol (MCP) for filesystem operations.

Features

• Read/write files
• Create/list/delete directories
• Move files/directories
• Search files
• Get file metadata

Note: The server will only allow operations within directories specified via args.

API

Resources

• file://system: File system operations interface

Tools

• read_file

  • Read complete contents of a file
  • Input: path (string)
  • Reads complete file contents with UTF-8 encoding

• read_multiple_files

  • Read multiple files simultaneously
  • Input: paths (string[])
  • Failed reads won’t stop the entire operation

• write_file

  • Create new file or overwrite existing (exercise caution with this)
  • Inputs:
    • path (string): File location
    • content (string): File content

• create_directory

  • Create new directory or ensure it exists
  • Input: path (string)
  • Creates parent directories if needed
  • Succeeds silently if directory exists

• list_directory

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

• move_file

  • Move or rename files and directories
  • Inputs:
    • source (string)
    • destination (string)
  • Fails if destination exists

• search_files

  • Recursively search for files/directories
  • Inputs:
    • path (string): Starting directory
    • pattern (string): Search pattern
  • Case-insensitive matching
  • Returns full paths to matches

• get_file_info

  • Get detailed file/directory metadata
  • Input: path (string)
  • Returns:
    • Size
    • Creation time
    • Modified time
    • Access time
    • Type (file/directory)
    • Permissions

• list_allowed_directories

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

Usage with Claude Desktop

Install the server

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

Add this to your claude_desktop_config.json:

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

License

This MCP server is licensed 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 see the LICENSE file in the project repository.