Rust Mcp Filesystem

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.

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

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](LICENSE) file for details.

Acknowledgments

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: rust-mcp-stack
• Source: rust-mcp-stack/rust-mcp-filesystem
• License: MIT
• Homepage: https://rust-mcp-stack.github.io/rust-mcp-filesystem/

Install and usage instructions live in the source repository linked above.