每日 MCP Server

Filesystem MCP Server：让 AI 安全访问本地文件系统

2026-07-29

文件仓库

支持客户端：

Claude CodeCursorVS CodeClaude Desktop

MCP文件系统官方

简介

Anthropic 官方维护的文件系统 MCP Server，让 Claude Code、Cursor 等客户端能够读写本地文件、列目录、搜索文件。

安装命令

npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir

Filesystem MCP Server

简介

由 Anthropic 官方维护的文件系统 MCP Server，是最基础也是使用最广泛的 MCP 之一。它允许 AI 客户端在指定目录范围内执行文件操作。

核心能力

工具	功能	用途
`read_file`	读取单个文件	查看代码、配置
`read_multiple_files`	批量读取	上下文加载
`write_file`	写入文件	代码生成、编辑
`edit_file`	编辑文件	精确修改
`list_directory`	列目录	浏览结构
`create_directory`	创建目录	项目初始化
`move_file`	移动/重命名	重构
`search_files`	搜索文件	查找资源
`get_file_info`	文件元信息	调试
`list_allowed_directories`	列出授权目录	安全审计

安装与配置

Claude Code

# 添加到 ~/.claude.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/projects",
        "/Users/yourname/documents"
      ]
    }
  }
}

Cursor

打开 Settings → MCP → Add Server：

{
  "name": "filesystem",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-filesystem", "/your/path"]
}

VS Code (Cline 插件)

在 Cline MCP 设置中添加相同配置。

安全模型

路径白名单：只能访问启动时指定的目录
符号链接限制：默认不跟随 symlink，防止越权
无 shell 执行：纯文件操作，不能执行命令

实战示例

场景 1：让 Claude 帮你整理项目

请遍历 /projects/my-app 目录，
列出所有 .ts 文件，
按行数排序，
并生成一个 README 说明各文件职责

场景 2：批量重命名

请把 /photos 下所有 IMG_*.jpg 文件
重命名为 2026-07-29_序号.jpg 格式

常见问题

Q: 能否访问系统目录？ A: 不建议。指定 / 等根目录会让 AI 能读到敏感文件，建议限定到具体项目目录。

Q: 写文件会覆盖吗？ A: 会。建议先用 git 提交，或让 AI 先用 edit_file 而非 write_file。

Q: 性能如何？ A: 单文件读取很快，但遍历大目录（10万+文件）会比较慢，建议配合 search_files 缩小范围。