适合谁
- 需要让本地 AI 助手处理明确目录中的文件
- 希望通过目录白名单控制数据范围的个人和开发团队
F
84FMRS · B
参考实现、路径边界清晰且安装简单；由于尚未记录固定 revision 下的实际握手测试，可靠性评分保留了运行验证分。
让模型可以在受控目录范围内浏览、读取、写入和管理文件，支持路径白名单与只读模式，是最基础也是使用最广泛的 MCP 之一，几乎所有本地工作流都会用到它。
工具能力
read_file
读取指定文件的完整内容
write_file
写入或创建新文件
list_directory
列出目录下的文件与子目录
create_directory
创建新目录
move_file
移动或重命名文件
search_files
按名称模式递归搜索文件
安装接入
在客户端配置文件中添加以下服务器条目，并将路径替换为需要授权访问的本地目录。
claude_desktop_config.json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/you/Documents"
]
}
}
}
选型与风险
不适合谁
- 无法接受模型读取本地文件内容的高敏感环境
- 需要多人共享远程文件服务的场景
所需权限
- 对配置中列出的本地目录拥有读取权限
- 使用写入、移动等工具时需要相应文件系统写权限
风险与副作用
- 授权目录中的敏感文件可能进入模型上下文
- 写入或移动工具会真实改变本地文件，应限制授权路径并保留备份
常见排障
- 确认 Node.js 与 npx 可用
- 检查配置路径存在且当前用户有权限
- 修改客户端配置后完全重启客户端
使用场景
整理本地项目文件，批量归档旧版本
让助手读取日志文件，协助排查问题
批量重命名一批图片或文档
支持客户端
Claude Desktop完整支持
Cursor完整支持
Cline完整支持
Windsurf部分支持