Skip to content
MCP Filesystem Ultra

Installation

This guide covers building and installing MCP Filesystem Ultra on different platforms.

Requirements

Section titled “Requirements”
  • Go 1.26.0 or later (download)
  • Git (optional, for cloning)
  • Windows, Linux, or macOS

Download

Section titled “Download”

Option 1: Clone from GitHub

Section titled “Option 1: Clone from GitHub”
Terminal window
git clone https://github.com/notcharliemarsh/mcp-filesystem-go-ultra.git
cd mcp-filesystem-go-ultra

Option 2: Download Release

Section titled “Option 2: Download Release”

Download the latest release from the GitHub Releases page.

Building from Source

Section titled “Building from Source”

Windows

Section titled “Windows”

Using the build script (recommended):

Terminal window
build-windows.bat

Manual build:

Terminal window
go mod tidy
go build -ldflags="-s -w" -trimpath -o filesystem-ultra.exe .

Linux / macOS

Section titled “Linux / macOS”
Terminal window
go mod tidy
go build -ldflags="-s -w" -trimpath -o filesystem-ultra .

Cross-Compilation

Section titled “Cross-Compilation”

Build Windows executable from Linux/WSL:

Terminal window
GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -trimpath -o filesystem-ultra.exe .

Build Linux executable from Windows:

Terminal window
set GOOS=linux
set GOARCH=amd64
go build -ldflags="-s -w" -trimpath -o filesystem-ultra .

Verify the Build

Section titled “Verify the Build”
Terminal window
# Check version
./filesystem-ultra.exe --version
# Output: MCP Filesystem Ultra v4.0.0


# Check help
./filesystem-ultra.exe --help

Binary Details

Section titled “Binary Details”

The optimized build produces:

  • Size: Approximately 8.8 MB
  • Dependencies: None (statically linked)
  • Platforms: Windows (amd64), Linux (amd64), macOS (amd64/arm64)

Installation Locations

Section titled “Installation Locations”

Windows

Section titled “Windows”

Recommended locations:

  • C:\Program Files\MCP\filesystem-ultra.exe
  • C:\Tools\filesystem-ultra.exe
  • Any directory in your PATH

Linux / macOS

Section titled “Linux / macOS”
Terminal window
# System-wide
sudo cp filesystem-ultra /usr/local/bin/


# User-only
cp filesystem-ultra ~/.local/bin/

Running Tests

Section titled “Running Tests”

Verify the installation with tests:

Terminal window
# Run all tests
go test ./tests/...
go test ./core/...


# Run with race detector
go test -race ./...


# Run security tests
go test ./tests/security/...

Build Flags Explained

Section titled “Build Flags Explained”
FlagPurpose
-ldflags="-s -w"Strip debug info and symbol table (smaller binary)
-trimpathRemove file paths from binary (reproducible builds)

Common Issues

Section titled “Common Issues”

”go: command not found”

Section titled “”go: command not found””

Install Go from go.dev/dl and add it to your PATH.

Build fails with module errors

Section titled “Build fails with module errors”

Run go mod tidy to resolve dependencies.

Cross-compiled binary not working

Section titled “Cross-compiled binary not working”

Ensure you set both GOOS and GOARCH correctly:

  • Windows: GOOS=windows GOARCH=amd64
  • Linux: GOOS=linux GOARCH=amd64
  • macOS Intel: GOOS=darwin GOARCH=amd64
  • macOS Apple Silicon: GOOS=darwin GOARCH=arm64

WSL: Windows paths not recognized

Section titled “WSL: Windows paths not recognized”

When building for Windows from WSL, always use:

Terminal window
GOOS=windows GOARCH=amd64 go build -o filesystem-ultra.exe .

This ensures the binary correctly handles Windows paths like C:\Users\... instead of converting them to WSL paths like /mnt/c/Users/....

Next Steps

Section titled “Next Steps”