Rust MCP Filesystem

Rust MCP Filesystem is a blazingly fast, asynchronous, and lightweight MCP (Model Context Protocol) server designed for efficient handling of various filesystem operations. This project is a pure Rust rewrite of the JavaScript-based @modelcontextprotocol/server-filesystem, offering enhanced capabilities, improved performance, and a robust feature set tailored for modern filesystem interactions.

📝 Refer to the project documentation for installation and configuration instructions.

⭐️ It is also available on Docker Hub’s MCP Registry at: https://hub.docker.com/mcp/server/rust-mcp-filesystem

Features

• ⚡ High Performance: Built in Rust for speed and efficiency, leveraging asynchronous I/O to handle filesystem operations seamlessly.
• 🔒 Read-Only by Default: Starts with no write access, ensuring safety until explicitly configured otherwise.
• 🔍 Advanced Glob Search: Supports full glob pattern matching allowing precise filtering of files and directories using standard glob syntax.For example, patterns like *.rs, src/**/*.txt, and logs/error-???.log are valid and can be used to match specific file types, recursive directory searches, or patterned filenames.
• 🔄 MCP Roots support: enabling clients to dynamically modify the list of allowed directories (disabled by default).
• 📦 ZIP Archive Support: Tools to create ZIP archives from files or directories and extract ZIP files with ease.
• 🪶 Lightweight: Standalone with no external dependencies (e.g., no Node.js, Python etc required), compiled to a single binary with a minimal resource footprint, ideal for both lightweight and extensive deployment scenarios.
• 🎛️ Tool Disabling: Disable specific tools to limit functionality and reduce the number of available tools, helping to save tokens.

👉 Refer to capabilities for a full list of tools and other capabilities.

🔧 Installation & Configuration

For detailed setup instructions, please visit the project documentation.

Quick installation guide

• Shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/download/v0.4.5/rust-mcp-filesystem-installer.sh | sh

• PowerShell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/download/v0.4.5/rust-mcp-filesystem-installer.ps1 | iex"

• Homebrew

brew install rust-mcp-stack/tap/rust-mcp-filesystem

Cargo

cargo install rust-mcp-filesystem --locked

• NPM

npm i -g @rustmcp/rust-mcp-filesystem@latest

The npm package is provided for convenience. It runs the same underlying Rust binary but can be installed and used as a standard npm package.

• Docker

  https://hub.docker.com/mcp/server/rust-mcp-filesystem

• Download Binaries

  https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/tag/v0.4.5

Purpose