← 返回目录

Filesystem MCP Server

官方

安全地读写本地文件与目录

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 文件系统第 1 / 24
Stars: ★ 91.2k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 无需凭据
许可证: 其他 / 未声明
最近提交: 3 天前
工具数: 6

84FMRS · B

参考实现、路径边界清晰且安装简单；由于尚未记录固定 revision 下的实际握手测试，可靠性评分保留了运行验证分。

最强项 · 安装易用性 18/20 最弱项 · 安全与权限 16/20

可靠性

17/20

安全与权限

16/20

维护活跃度

16/20

文档质量

17/20

安装易用性

18/20

实测已过期收录于 2026-07-13

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件

适合谁

需要让本地 AI 助手处理明确目录中的文件
希望通过目录白名单控制数据范围的个人和开发团队

不适合谁

无法接受模型读取本地文件内容的高敏感环境
需要多人共享远程文件服务的场景

所需权限

对配置中列出的本地目录拥有读取权限
使用写入、移动等工具时需要相应文件系统写权限

风险与副作用

授权目录中的敏感文件可能进入模型上下文
写入或移动工具会真实改变本地文件，应限制授权路径并保留备份

安装接入

准备工作

运行环境：Node.js

在客户端配置文件中添加以下服务器条目，并将路径替换为需要授权访问的本地目录。

claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/Documents"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/Documents"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /Users/you/Documents

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 read_file、list_directory 等工具；连接后可让 AI 执行 list_directory，若能返回所配置允许目录（如 /Users/you/Documents）中的文件列表，即证明安装成功。

常见排障

确认 Node.js 与 npx 可用
检查配置路径存在且当前用户有权限
修改客户端配置后完全重启客户端

试试这样问

连接成功后，可以直接对 AI 助手这样说：

读取我 Documents 目录下 notes.txt 的内容
列出我的 Documents 文件夹里有哪些文件
在 Documents 里新建一个名为 projects 的文件夹
把 report.txt 移动到 archive 文件夹里

工具能力 6

read_file 只读

读取指定文件的完整内容

write_file 写入

写入或创建新文件

list_directory 只读

create_directory 写入

创建新目录

move_file 写入

移动或重命名文件

search_files 只读

按名称模式递归搜索文件

使用场景

整理本地项目文件，批量归档旧版本

让助手读取日志文件，协助排查问题

批量重命名一批图片或文档

支持客户端

Claude Desktop

Cursor

Cline

Windsurf部分支持

依据项目文档列出，未经本站实测。

详细介绍

让模型可以在受控目录范围内浏览、读取、写入和管理文件，支持路径白名单与只读模式，是最基础也是使用最广泛的 MCP 之一，几乎所有本地工作流都会用到它。