<p align="center"> <img width="96" src="./docs/_media/rust-mcp-filesystem.png" alt="Rust MCP 文件系统 Logo" width="300"> </p>

Rust MCP 文件系统

Rust MCP 文件系统是一个快速、异步且轻量级的 MCP（模型上下文协议）服务器，旨在高效处理各种文件系统操作。 该项目是基于 JavaScript 的 @modelcontextprotocol/server-filesystem 的纯 Rust 重写版，提供了增强的功能、改进的性能以及一套针对现代文件系统交互的健壮特性集。

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

⭐️ 它也发布在 Docker Hub 的 MCP 注册表 上：https://hub.docker.com/mcp/server/rust-mcp-filesystem

特性

• ⚡ 高性能：用 Rust 编写，以速度和效率著称，利用异步 I/O 来无缝处理文件系统操作。
• 🔒 默认只读：默认无写入权限，确保安全直到明确配置其他权限。
• 🔍 高级通配符搜索：支持完整的通配符模式匹配，允许使用标准通配符语法精确过滤文件和目录。例如，模式如 *.rs、src/**/*.txt 和 logs/error-???.log 是有效的，并可用于匹配特定文件类型、递归目录搜索或模式化文件名。
• 🔄 支持 MCP 根目录：允许客户端动态修改允许的目录列表（默认禁用）。
• 📦 ZIP 归档支持：提供工具从文件或目录创建 ZIP 归档，并轻松提取 ZIP 文件。
• 🪶 轻量级：独立运行，无需外部依赖（例如不需要 Node.js、Python 等），编译成单一二进制文件，资源占用极小，适用于轻量级和大规模部署场景。

👉 请参阅 功能列表 获取完整工具和其他功能列表。

🔧 安装与配置

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

快速安装指南

<!-- x-release-please-start-version -->

• Shell 脚本

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/download/v0.3.8/rust-mcp-filesystem-installer.sh | sh

• PowerShell 脚本

powershell -ExecutionPolicy Bypass -c "irm https://github.com/rust-mcp-stack/rust-mcp-filesystem/releases/download/v0.3.8/rust-mcp-filesystem-installer.ps1 | iex"

• Homebrew

brew install rust-mcp-stack/tap/rust-mcp-filesystem

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

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

目标

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

🧰 构建于

该项目利用了 rust-mcp-sdk 和 rust-mcp-schema 来构建此服务器。如果您有兴趣打造自己的 Rust 基础的 MCP 项目或将现有项目转换为 Rust 以获得增强的性能和安全性，请查看这些仓库。

许可证

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

致谢

受 @modelcontextprotocol/server-filesystem 启发，并借助 Rust 的力量构建。