Rust MCP Filesystem

Rust MCP Filesystem

Rust MCP Filesystem 是一款极速、异步且轻量的 MCP（Model Context Protocol）服务，专为高效处理各种文件系统操作而设计。 该项目是对基于 JavaScript 的 @modelcontextprotocol/server-filesystem 的纯 Rust 重写版本，提供更强大的能力、更出色的性能，以及针对现代文件系统交互打造的丰富功能。

📝 安装和配置说明请参阅项目文档。

⭐️ 该项目也已收录于 Docker Hub 的 MCP Registry：https://hub.docker.com/mcp/server/rust-mcp-filesystem

功能

• ⚡ 高性能：使用 Rust 构建，速度快、效率高，并利用异步 I/O 无缝处理文件系统操作。
• 🔒 默认只读：启动时不具备写入权限，只有显式配置后才能写入，确保安全。
• 🔍 高级 Glob 搜索：支持完整的 glob 模式匹配，可使用标准 glob 语法精确筛选文件和目录。例如，*.rs、src/**/*.txt 和 logs/error-???.log 等模式均有效，可用于匹配特定文件类型、递归搜索目录或匹配符合模式的文件名。
• 🔄 支持 MCP Roots：允许客户端动态修改允许访问的目录列表（默认禁用）。
• 📦 ZIP 归档支持：提供从文件或目录创建 ZIP 归档，以及轻松解压 ZIP 文件的工具。
• 🪶 轻量：独立运行，无需外部依赖（例如，无需 Node.js、Python 等），可编译为单个二进制文件，资源占用极少，适用于轻量部署和大规模部署场景。
• 🎛️ 禁用工具：禁用特定工具以限制功能并减少可用工具数量，从而节省令牌。

👉 完整的工具和其他功能列表请参阅功能说明。

🔧 安装与配置

详细的设置说明请访问项目文档。

快速安装指南

• Shell 脚本

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 脚本

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

提供 npm 包是为了方便使用。该包运行相同的底层 Rust 二进制文件，但可以像标准 npm 包一样安装和使用。

• Docker

  https://hub.docker.com/mcp/server/rust-mcp-filesystem

• 下载二进制文件

  https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/tag/v0.4.5

项目目的

本项目旨在为文件系统管理提供可靠、安全且功能丰富的 MCP 服务，以性能更高、类型安全性更强的语言重新构想 @modelcontextprotocol/server-filesystem 的能力。无论你是在构建用于文件探索、自动化还是系统集成的工具，rust-mcp-filesystem 都能提供坚实的基础。

🧰 构建所用技术

本项目借助 rust-mcp-sdk 和 rust-mcp-schema 构建此服务。如果你有兴趣开发自己的 Rust MCP 项目，或将现有项目转换为 Rust 以提升性能和安全性，不妨查看这些代码仓库。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

致谢

本项目受到 @modelcontextprotocol/server-filesystem 的启发，并借助 Rust 的强大能力构建而成。