Filesys

🚀 File System MCP Server

A secure Model Context Protocol (MCP) server that provides controlled access to file system operations in specified directories.

✨ Features

• Control directory access through environment variables.
• File operations are restricted to allowed directories.
• Thread-safe caching for allowed directories.
• Proper handling of paths containing spaces.

📦 Installation

go get github.com/gomcpgo/filesys

Configuration

Set the allowed directories using environment variables:

export MCP_ALLOWED_DIRS="/path1,/path2,/path with spaces/dir3"

Toolset

File Reading

• read_file: Read the content of a single file.
• read_multiple_files: Read multiple files simultaneously.

File Writing

• write_file: Create or overwrite a file.

Directory Operations

• create_directory: Create a new directory.
• list_directory: List the contents of a directory.
• list_allowed_directories: Display accessible directories.

File Management

• move_file: Move or rename files and directories.
• get_file_info: Get file metadata.
• search_files: Recursively search for files with pattern matching.

Integration with Claude Desktop

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "/path/to/filesys",
      "env": {
        "MCP_ALLOWED_DIRS": "/path1,/path2,/path with spaces/dir3"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

Reading a File

{
    "name": "read_file",
    "arguments": {
        "path": "/allowed/path/file.txt"
    }
}

Listing Directory Contents

{
    "name": "list_directory",
    "arguments": {
        "path": "/allowed/path"
    }
}

Security

• All operations are restricted to allowed directories.
• Prevent path traversal attacks.
• Perform permission verification before operations.
• Properly handle errors and logging.

Build

go build -o bin/filesys cmd/main.go

📄 License

MIT License

Project Contribution

Pull requests are welcome. Please ensure:

• Tests pass.
• New features include documentation.
• Code follows the project style.