Rust MCP Filesystem

by rust-mcp-stack

163 stars
721 downloads
Not rated
GitHub Website

About

Blazing-fast, asynchronous MCP server for seamless filesystem operations.

Details

Author
rust-mcp-stack
GitHub stars
163
Downloads
721
Categories
Other

- Blazingly fast async I/O built in Rust.
- Read-only by default for safety; write access must be explicitly enabled.
- Full glob pattern search (e.g., .rs, src//.txt).
- MCP Roots support for dynamic directory whitelisting (disabled by default).
- ZIP archive creation and extraction tools.
- Ability to disable specific tools to save tokens.

Install via shell script, PowerShell, Homebrew, Cargo, npm, Docker, or download a pre-built binary. No external runtime (e.g., Node.js) is required. Detailed configuration instructions are available in the project documentation. The server runs as a standalone binary; clients connect per the MCP protocol.

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

<!-- x-release-please-start-version -->
-
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

<!-- x-release-please-end -->

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.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.