Rust MCP Filesystem

v1.0.0File Systemsstable

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

filesystemmcp-serverrust-mcprust-mcp-stack
Share:
150
Stars
0
Downloads
0
Weekly
0/5

What is Rust MCP Filesystem?

Rust MCP Filesystem is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to blazing-fast, asynchronous mcp server for seamless filesystem operations.

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

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Blazing-fast, asynchronous MCP server for seamless filesyste

Use Cases

Perform fast filesystem operations asynchronously
Enable AI file manipulation and management
Access files through MCP interface
rust-mcp-stack

Maintainer

LicenseMIT License
Languagerust
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx rust-mcp-filesystem

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Rust MCP Filesystem

Rust MCP Filesystem is a high-performance, asynchronous MCP server written in Rust that provides AI clients with comprehensive filesystem access — including file reading and writing, directory listing, glob pattern matching, and ZIP archive creation and extraction. It is a Rust-native reimplementation of the official TypeScript filesystem MCP server, designed to be significantly faster and to run as a standalone binary with no Node.js, Python, or other runtime dependency. Developers use it when they want the standard filesystem MCP capabilities with lower latency, smaller resource footprint, or on systems where installing Node.js is undesirable.

Prerequisites

  • One of: Homebrew (macOS/Linux), Cargo (Rust toolchain), npm/npx, or curl for binary installation
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with MCP support
  • The directories you want to expose to the MCP server must exist and be readable by the running user
  • Write access must be explicitly granted in configuration — the server is read-only by default
1

Install rust-mcp-filesystem using your preferred method

Choose one of several installation methods. Homebrew and the shell installer are the most convenient on macOS/Linux; npm install works if you already have Node.

# Homebrew (macOS/Linux)
brew install rust-mcp-stack/tap/rust-mcp-filesystem

# Shell installer
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

# npm (global)
npm i -g @rustmcp/rust-mcp-filesystem@latest

# Cargo (from source)
cargo install rust-mcp-filesystem --locked
2

Configure Claude Desktop to use the server

Add rust-mcp-filesystem to your Claude Desktop config, passing the allowed directory paths as arguments. The server is read-only unless you enable write access.

{
  "mcpServers": {
    "filesystem": {
      "command": "rust-mcp-filesystem",
      "args": ["/Users/yourname/projects"]
    }
  }
}
3

Enable write access if needed

By default the server is read-only. Pass the appropriate flag to allow write operations on the specified directories.

{
  "mcpServers": {
    "filesystem": {
      "command": "rust-mcp-filesystem",
      "args": ["--allow-write", "/Users/yourname/projects"]
    }
  }
}
4

Verify the server starts correctly

Test the binary by running it directly in your terminal with a test path to confirm it initialises without errors before adding it to your client config.

rust-mcp-filesystem /tmp
5

Restart Claude Desktop and test a filesystem operation

Restart your MCP client after saving the config. Then ask it to list files in a directory or read a file to confirm the integration is working.

Rust MCP Filesystem Examples

Client configuration

Claude Desktop configuration using the npm-installed package, granting read-write access to a specific project directory.

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@rustmcp/rust-mcp-filesystem", "--allow-write", "/Users/yourname/projects"]
    }
  }
}

Prompts to try

Filesystem operations you can ask Claude to perform once rust-mcp-filesystem is connected.

- "List all .rs files in /Users/yourname/projects/my-app recursively"
- "Read the contents of /Users/yourname/projects/my-app/src/main.rs"
- "Create a ZIP archive of the /Users/yourname/projects/my-app/src directory"
- "Find all files matching the glob pattern **/*.toml in my project"
- "Write the following content to /Users/yourname/projects/my-app/notes.txt: 'TODO: fix issue #42'"

Troubleshooting Rust MCP Filesystem

Permission denied errors when reading or writing files

Ensure the user running the MCP server has the appropriate OS-level file permissions on the target directory. For write operations, also confirm you have passed the --allow-write flag in the args array.

rust-mcp-filesystem command not found after npm install

The npm package installs the binary as @rustmcp/rust-mcp-filesystem. Use npx @rustmcp/rust-mcp-filesystem in the command field instead of rust-mcp-filesystem, or use the Homebrew or shell installer methods to get a globally available binary.

The server refuses to access paths outside the configured directories

This is intentional security behaviour — the server only allows access to directories passed as arguments. Add additional allowed paths as extra arguments in the args array of your config.

Frequently Asked Questions about Rust MCP Filesystem

What is Rust MCP Filesystem?

Rust MCP Filesystem is a Model Context Protocol (MCP) server that blazing-fast, asynchronous mcp server for seamless filesystem operations. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Rust MCP Filesystem?

Follow the installation instructions on the Rust MCP Filesystem GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Rust MCP Filesystem?

Rust MCP Filesystem works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Rust MCP Filesystem free to use?

Yes, Rust MCP Filesystem is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "rust-mcp-filesystem": { "command": "npx", "args": ["-y", "rust-mcp-filesystem"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Rust MCP Filesystem?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides