Happy slice of mcp pizzaMCP.pizza

rust-mcp-filesystem

MCP.Pizza Chef: rust-mcp-stack

A small program you install locally and point at a specific list of folders, which is all it can ever see. It arrives read-only, so out of the box the assistant can browse, read, preview the start or end of a long file, search inside file contents, spot duplicates and measure folder sizes. Adding the write flag also allows creating, editing, moving and zipping. Twenty-four tools are registered, and none of them can delete a file. No account or key is involved.

Data
Files/PDF

Use This MCP server To

Find every document in my Downloads folder mentioning a phrase Show me which folders are eating my disk space List duplicate files I have saved twice by accident Read the last few pages of a very long file Search my whole project folder for a half-remembered sentence Zip a finished folder up before I email it

README

Rust MCP Filesystem Logo

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.2/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.2/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.

Purpose

This project aims to provide a reliable, secure, and feature-rich MCP server for filesystem management, reimagining the capabilities of @modelcontextprotocol/server-filesystem in a more performant and type-safe language. Whether you’re building tools for file exploration, automation, or system integration, rust-mcp-filesystem offers a solid foundation.

🧰 Built With

The project leverages the rust-mcp-sdk and rust-mcp-schema to build this server. check out those repositories if you’re interested in crafting your own Rust-based MCP project or converting existing ones to Rust for enhanced performance and safety.

License

This project is licensed under the MIT License. see the LICENSE file for details.

Acknowledgments

Inspired by @modelcontextprotocol/server-filesystem and built with the power of Rust.

rust-mcp-filesystem FAQ

Can I use this to tidy up duplicate files?
It will find and list duplicates and empty folders for you, but it has no delete tool of any kind, so you still remove them yourself.
Can the assistant change my files?
Not at first. It starts read-only and refuses every write; you have to launch it with the allow-write flag before it can create, edit, move or zip anything.
Can it see everything on my computer?
Only the folders you name when you start it. Everything else is refused, and you can also switch individual tools off by name.
Do I need an account, key or subscription?
No. It runs entirely on your machine, talks to no outside service, and costs nothing.
How hard is this to set up?
You install a small program first, using Homebrew, npm, Docker or a downloaded file, then paste a short block into your assistant's settings listing the folders it may open.
Which apps does it work with?
Any assistant that supports MCP servers, including Claude Desktop, Cursor and VS Code. It is also published on Docker's MCP registry.