跳到主要内容
Ed. notes

Filesystem MCP:给 Agent 一个受限的文件系统入口

仓库 · 2026-11-10

  • MCP
  • 文件系统
  • 官方服务器

结论

Filesystem MCP 是最容易跑起来的官方参考服务器之一:启动时指定一个目录,Agent 就只能在这个范围里读写。它适合把本地文档、仓库或资料目录交给模型,但「能写」意味着必须自己控制权限和备份。

它解决什么问题

模型本身不能安全地访问本地文件。直接给 shell 权限太大,自己写一套文件工具又重复。Filesystem MCP 提供一组标准工具:读文件、列目录、搜索、查看元信息,以及写文件、追加、编辑、移动和复制。目录边界由启动参数决定,不靠提示词约束;换句话说,越界不是「模型不听话」,而是服务器直接拒绝。

我的实验

把仓库根目录作为唯一允许目录启动,先列出工具,得到 16 个:

read_file、read_text_file、read_media_file、read_multiple_files、write_file、append_file、edit_file、create_directory、list_directory、list_directory_with_sizes、directory_tree、move_file、copy_file、search_files、get_file_info、list_allowed_directories。

再用 read_text_file 读取 README.md 的前 12 行,返回了项目标题、技术栈和当前阶段,内容与磁盘一致。list_allowed_directories 则可以直接确认当前进程被允许访问的根目录。

限制

  • 只允许访问启动时传入的目录,路径越界会被拒绝;多目录需要显式传入。
  • 写入、编辑、移动和复制都能改数据,接入 Agent 前要限定目录、加备份或改成只读。
  • 搜索以文件名和文本为主,不是语义检索;大目录仍要配合忽略规则。
  • 它不提供版本控制;误改后能否恢复取决于仓库或备份,而不是服务器。
  • 官方仓库同时维护多个服务器,升级时注意各自版本和兼容性。

适合谁

想让 Agent 读取本地文档、代码或素材目录的人。只需要读少量文件时,直接用工具读文件更简单。

继续探索