Filesys MCP Server

A secure, single-binary MCP server for filesystem operations. No runtime dependencies — download, configure allowed directories, and connect to any

Local serverstdioPython

What is the Filesys MCP Server?

Filesys becomes available to MCP clients through the filesys mcp server. A secure, single-binary MCP server for filesystem operations. No runtime dependencies — download, configure allowed directories, and connect to any MCP client.

What Filesys does

A secure, single-binary MCP server for filesystem operations. No runtime dependencies — download, configure allowed directories, and connect to any MCP client.

Key capabilities

  • Single binary — — no Node.js, Python, or other runtime needed. Download and run
  • Tested with real AI workflows — — battle-tested with Claude Desktop and Claude Code for day-to-day coding tasks
  • 18 tools — — goes beyond basic read/write with regex search, pattern-based replacement, auto-indented code insertion, and batch operations
  • Dry-run preview — — preview changes before applying them for replacement and insertion tools
  • Secure by default — — sandboxed to configured directories with symlink attack prevention and path traversal protection
  • Detailed error messages — — when access is denied, errors explain why and suggest fixes

Practical notes

  • Maintained by gomcpgo, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Filesys MCP Server

{
  "mcpServers": {
    "filesystem": {
      "command": "/path/to/filesystem-mcp-darwin-arm64",
      "env": {
        "MCP_ALLOWED_DIRS": "/path1,/path2,/path with spaces/dir3"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
MCP_ALLOWED_DIRSFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Filesys to Reading.”
  • “Use Filesys to Writing.”

Frequently asked questions

A secure, single-binary MCP server for filesystem operations. No runtime dependencies — download, configure allowed directories, and connect to any MCP client. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.