Rust MCP Filesystem MCP server
Commit Aug 29, 2026Lets an AI client read, search, copy, move, and archive files and directories on the local filesystem through MCP tools.
Also known as rust-mcp-stack/rust-mcp-filesystem
- Stars
- 185
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Aug 29, 2026
- License
- MIT
What is Rust MCP Filesystem MCP?
Rust MCP Filesystem lets an AI client read, search, copy, move, and archive files and directories on the local filesystem through MCP tools.
Summary generated from the project's README
About Rust MCP Filesystem MCP server
Managing local files and directories through an AI client is possible with rust-mcp-filesystem. This server provides a high-performance way to read, search, copy, move, and archive files using asynchronous I/O. It is built in Rust as a standalone binary, meaning it does not require Node.js or Python to run, making it a lightweight option for local or containerized environments via Docker.
Security is a priority because the server starts in a read-only mode by default, requiring explicit configuration to enable write access. Users can manage their workspace using advanced glob pattern matching for precise file filtering and can utilize ZIP archive tools to create or extract compressed files. To help manage context window limits, developers can disable specific tools to reduce the total number of available commands sent to the AI.
Setup is flexible, supporting installation through Homebrew, Cargo, NPM, or direct binary downloads. It also includes MCP Roots support, which allows clients to dynamically change the list of permitted directories.
What you can do with it
- 1Locate specific files using patternsFind all Rust source files within a specific directory tree using glob syntax.
- 2Compress and extract archivesBundle multiple files into a single ZIP archive for easier transfer.
- 3Manage AI token usageLimit the number of tools available to the AI to save on context costs.
- 4Secure file explorationBrowse local directories without risking accidental file modifications.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablerust-mcp-stack/rust-mcp-filesystem is public and reachablegithub.com/rust-mcp-stack/rust-mcp-filesystem ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-29github.com/rust-mcp-stack/rust-mcp-filesystem ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubRust 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, andlogs/error-???.logare 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
-
Download Binaries
https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/tag/v0.4.5
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 MCP questions
Is write access enabled by default?
No. The server starts with no write access and only allows writes once directories are explicitly configured.
Does it support glob pattern searches?
Yes, it supports full glob pattern matching to filter files and directories.
Can it create or extract ZIP archives?
Yes, it includes tools to create ZIP archives from files or directories and to extract ZIP files.
Can I install it without Node.js or Python?
Yes. It is a standalone Rust binary with no external runtime dependencies.
Can specific tools be disabled?
Yes, you can disable individual tools to limit functionality and reduce the number of available tools.