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 缩小范围。