Filesys

Filesystem MCP Server

A secure Model Context Protocol (MCP) server that provides filesystem operations with controlled access to specified directories.

Features

• Directory access controlled via environment variables
• File operations within allowed directories only
• Thread-safe caching of allowed directories
• Proper handling of paths with spaces

Installation

go get github.com/gomcpgo/filesys

Configuration

Set allowed directories using the environment variable:

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

Tools

File Reading

• read_file: Read single file contents
• read_multiple_files: Read multiple files simultaneously

File Writing

• write_file: Create or overwrite files

Directory Operations

• create_directory: Create new directories
• list_directory: List directory contents
• list_allowed_directories: Show accessible directories

File Management

• move_file: Move or rename files and directories
• get_file_info: Get file metadata
• search_files: Search files recursively with pattern matching

Usage with Claude Desktop

Add to claude_desktop_config.json:

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

Tool Examples

Reading a File

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

Listing Directory

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

Security

• All operations restricted to allowed directories
• Path traversal prevention
• Permission validation before operations
• Proper error handling and logging

Building

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

License

MIT License

Contributing

Pull requests welcome. Please ensure:

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