← MCP 图谱
Filesystem MCP Server
Model Context Protocol
文件
本地
只读
读写
verified
lifecycle: active
核验 2026-09-29
MCP 官方 reference server 里的文件操作实现,强制显式声明允许目录,不允许静默访问全盘。
适合与不适合
让 Agent 在明确指定的目录内读写文本与媒体文件。需要目录边界清晰、
固定坐标系
11 个维度,与同赛道其他对象逐项可比。
- 模型与开放条件
- 本身不调用模型,是被客户端调用的接口实现。 协议兼容性取决于客户端实现,仓库未声明最低协议版本。
- 运行位置
- 本地 Node.js 子进程,通过 stdio 与客户端通信。 生命周期绑定客户端进程,客户端退出即停止。
- 本地文件
- 核心能力。默认不支持无限制访问: 必须通过命令行参数指定允许目录,或客户端支持 Roots 协议动态下发。 若无参数启动且客户端不支持 roots,server 在初始化阶段直接报错。
- 关机后的任务
- 不支持。本地 stdio 进程随客户端生死, 无独立守护或云端执行形态。
- 工具与扩展
- 提供 11 个工具:read_text_file、read_media_file、read_multiple_files、 write_file、edit_file、create_directory、list_directory、 list_directory_with_sizes、move_file、search_files、directory_tree。 输出为结构化内容,可直接消费。
- 上下文与记忆
- 无状态。每次调用独立,不保留会话记忆。 list_allowed_directories 可查询当前生效目录。
- 权限与限制
- 无独立审批机制,权限边界完全由允许目录决定。 全部文件操作限制在允许目录内,越界会被拒绝。 注意:提供 write_file / edit_file / move_file / create_directory, 属可写但无删除工具的组合。
- 适合什么任务
- 让 Agent 安全读写指定目录内的文本与媒体文件。 不适合需要删除操作或需要跨目录聚合的场景。
- 传输方式
- 仅 stdio。本地 Node.js 进程,通过标准输入输出通信。 未声明支持 SSE 或 Streamable HTTP。
- 认证机制
- 无独立认证层。stdio 形态继承启动它的客户端用户的全部文件权限。 权限边界不是认证机制,而是目录白名单。
- 权限范围
- 默认范围窄且强制显式:必须通过命令行参数指定允许目录, 或客户端支持 Roots 协议动态下发。 无参数且客户端不支持 roots 时,server 初始化即报错。 不提供删除工具;提供写入、编辑、移动、建目录。 可用 list_allowed_directories 查询当前生效目录。
头号误解
- 以为官方仓库的 server 可以直接上生产,README 明确声明仅供参考实现
- 不传目录参数就启动,会在初始化阶段报错而不是静默访问全盘
- 以为没给 write 类工具就不能改文件,write_file / edit_file 确实可写
价格
| 月度入口 | 无商业费用 |
|---|---|
| 年付 | 无商业费用 |
| 额度说明 | npm 发布为 @modelcontextprotocol/server-filesystem,开源无授权费。 实际成本来自所访问资源所在机器与账号,不来自本 server。 |
不同币种不做折算。优惠、地区、税费与登录后报价可能变化,购买前请到官方页面确认。
未知项清单
- 最低协议版本要求(仓库未声明)
证据来源
判断可回到以下一手源复核。本站核验日 2026-09-29,内容更新日 2026-09-29。
| 类型 | 名称 | 链接 |
|---|---|---|
| changelog | MCP · Servers Releases(2026.8.31 / 2026.8.18 / 2026.7.10) | https://github.com/modelcontextprotocol/servers/releases |
| changelog | MCP · Filesystem 目录变更历史 | https://github.com/modelcontextprotocol/servers/commits/main/src/filesystem |
| docs | MCP · Filesystem Server | https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem |
| repo | MCP · Servers 仓库 README(含生产环境免责声明) | https://github.com/modelcontextprotocol/servers |
| docs | MCP · 规范 | https://modelcontextprotocol.io/specification |
实测记录
本站尚未完成实测。测试协议见 tasks/_protocol.md。
本页由 ai-coding-agent-atlas 数据层生成(CC BY 4.0)。
方法论与坐标系定义见仓库内 METHODOLOGY.md。