v2.0.0

mcp-filesystem Release v2.0.0

Installation

IMPORTANT

This MCP Server requires a config.json file to be created in the same directory as the compiled executable. This allows MCP servers to be shared between multiple clients rather than managing the configuration within the client itself.

Windows Example

{
  "allowedDirectories": [
    "C:\\Users\\Username\\AppData\\Roaming\\Claude",
    "C:\\Users\\Username\\node_modules\\@modelcontextprotocol",
    "D:\\Github\\"
  ]
}

Linux Example

{
  "allowedDirectories": [
    "/data/github",
    "/home"
  ]
}

Download the appropriate binary for your platform and create the config file:

Linux (x86_64):

wget https://github.com/LaurieRhodes/mcp-filesystem-go/releases/download/v2.0.0/mcp-filesystem-linux-amd64
chmod +x mcp-filesystem-linux-amd64
sudo mkdir -p /usr/local/bin/mcp-servers/filesystem
sudo mv mcp-filesystem-linux-amd64 /usr/local/bin/mcp-servers/filesystem/mcp-filesystem

# Create config file with your allowed directories
sudo tee /usr/local/bin/mcp-servers/filesystem/config.json > /dev/null <<'CONFIG'
{
  "allowedDirectories": [
    "/home",
    "/tmp"
  ]
}
CONFIG

Linux (ARM64):

wget https://github.com/LaurieRhodes/mcp-filesystem-go/releases/download/v2.0.0/mcp-filesystem-linux-arm64
chmod +x mcp-filesystem-linux-arm64
sudo mkdir -p /usr/local/bin/mcp-servers/filesystem
sudo mv mcp-filesystem-linux-arm64 /usr/local/bin/mcp-servers/filesystem/mcp-filesystem

# Create config file with your allowed directories
sudo tee /usr/local/bin/mcp-servers/filesystem/config.json > /dev/null <<'CONFIG'
{
  "allowedDirectories": [
    "/home",
    "/tmp"
  ]
}
CONFIG

macOS (Intel):

wget https://github.com/LaurieRhodes/mcp-filesystem-go/releases/download/v2.0.0/mcp-filesystem-darwin-amd64
chmod +x mcp-filesystem-darwin-amd64
sudo mkdir -p /usr/local/bin/mcp-servers/filesystem
sudo mv mcp-filesystem-darwin-amd64 /usr/local/bin/mcp-servers/filesystem/mcp-filesystem

# Create config file with your allowed directories
sudo tee /usr/local/bin/mcp-servers/filesystem/config.json > /dev/null <<'CONFIG'
{
  "allowedDirectories": [
    "/Users/username/Documents",
    "/Users/username/Projects"
  ]
}
CONFIG

macOS (Apple Silicon):

wget https://github.com/LaurieRhodes/mcp-filesystem-go/releases/download/v2.0.0/mcp-filesystem-darwin-arm64
chmod +x mcp-filesystem-darwin-arm64
sudo mkdir -p /usr/local/bin/mcp-servers/filesystem
sudo mv mcp-filesystem-darwin-arm64 /usr/local/bin/mcp-servers/filesystem/mcp-filesystem

# Create config file with your allowed directories
sudo tee /usr/local/bin/mcp-servers/filesystem/config.json > /dev/null <<'CONFIG'
{
  "allowedDirectories": [
    "/Users/username/Documents",
    "/Users/username/Projects"
  ]
}
CONFIG

Windows (x86_64):
Download mcp-filesystem-windows-amd64.exe and add to your PATH.

Verification

Verify your download using the SHA256 checksums:

sha256sum -c mcp-filesystem-<platform>-<arch>.sha256

Documentation

• Quick Start Guide
• Full Documentation

What's New

See CHANGELOG.md for details.