MCP 社区
文件系统工作组章程

文件系统工作组章程

社区译文；来源： MCP 80041ab0

小组类型

工作组

使命陈述

文件系统工作组负责让 MCP Resources 支持双向操作，使 agent 能够把结果写回其读取输入的服务器。各 agent 平台正逐渐采用文件系统的形式向模型提供服务，而 Resources 已经通过 URI 标识内容，其中规范定义的 file:// scheme 用于标识“行为类似文件系统的资源”。目前，Resources 只支持该表面的读取方向。本 WG 将产出一份 Extensions Track SEP，统一涵盖写入操作、乐观并发控制，以及写入与变更通知和缓存的交互。

范围

范围内

  • 规范工作：产出一份暂定名为 Filesystem Operations for Resources 的 Extensions Track SEP，涵盖：
    1. 操作。 定义 create、update、delete，以及元数据读取操作（stat）；该操作无需获取正文，即可返回一个 URI 是否存在、大小和最后修改时间。
    2. 乐观并发控制。 规定两个写入方如何避免更新丢失，以及客户端如何在“仅当不存在时创建”的前置条件下创建资源。
    3. 变更通知与缓存。 规定写入如何与 notifications/resources/updated、存活时间和缓存范围字段 ttlMs 与 cacheScope，以及 lastModified annotation 交互。
  • 跨领域事项：把扩展这一原语的各项提案协调为一个一致的设计。 SEP-2571：用于 Agent 协调的资源提交提出 resources/create 和 resources/delete。 SEP-2532：用于二进制内容传递的资源流式传输提出 resources/stream。 SEP-1708：由 MCP 客户端中介的文件系统访问曾提出与 Resources 并列的 files/* 方法族，并已于 2026 年 1 月 23 日关闭。
  • 文档：在规范中记录新操作，并向服务器作者说明如何在资源写入路径和基于工具的路径之间进行选择。

范围外

  • 与 Resources 并列的平行 files/* 原语。WG 扩展现有的 Resources 原语。
  • 宿主端沙箱和本地磁盘语义。WG 标准化客户端和服务器的线协议格式；宿主如何为模型把资源实现为文件系统，仍属于宿主关注事项。
  • 写入授权策略，但会说明现有 MCP 授权规范适用的位置。

相关小组

  • File Uploads WG。 两组都会向服务器传输内容，需要协调面向上传的流程在哪里结束，以及资源写入操作从哪里开始。
  • Skills Over MCP WG。 已发布的 Skills 扩展使用 Resources 读取文件，并定义可选的目录读取。它不依赖文件系统写入操作；双方应就未来会影响 skills 的资源操作进行协调。
  • Agents IG。 多 agent 和作业编排系统是共享写入路径的主要需求方。

领导

角色姓名组织GitHub任期
LeadSambhav KothariBloomberg@sambhav初始
LeadOla HungerfordNordstrom@olaservo初始
LeadDaniel TemesgenBloomberg@DanielTemesgen初始

权限与决策权

决策类型权限级别
会议后勤与日程安排WG Lead（自主决定）
WG 内提案优先级WG Lead（自主决定）
SEP 分诊与关闭（范围内）WG Lead（自主决定，并记录理由）
范围内技术设计WG 共识
规范更改（增量）WG 共识 → Core Maintainer 批准
规范更改（破坏性/根本性）WG 共识 → Core Maintainer 批准 + 更广泛评审
扩大范围必须获得 Core Maintainer 批准
批准 WG MemberWG Member 赞助人

成员

姓名组织GitHubDiscord层级
Michael CheahBloomberg@michaelcheahWG Member

运作方式

会议频率时长目的
工作会议每两周一次60 分钟技术讨论、提案评审

Discord：#filesystems-wg。

注意：上述频率是临时安排，可能会在第一次工作会议确定后发生变化。

交付物与成功指标

活跃工作项

项目状态目标日期负责人
SEP：Filesystem Operations for Resources构思中待定
与 SEP-2571 作者共同推进该提案构思中待定

本组的第一项行动是与 SEP-2571 的作者共同推进该提案，因为它已经涵盖 create 和 delete。

成功标准

  • 一份获接受的 Extensions Track SEP，涵盖 create、update、delete 和 stat，定义乐观并发控制机制，并规定其与 notifications/resources/updated、ttlMs、cacheScope 和 lastModified 的交互。
  • 解决这一领域中的每项提案。在撰写本文时，SEP-2571 和 SEP-2532 仍处于开放状态；每项提案最终都应被纳入、被取代或明确排除在范围外。
  • 至少两个 Tier 1 SDK 提供参考实现。
  • 两个相互独立的服务器实现能够针对同一个客户端使用该写入路径。

变更日志

日期变更
2026-08-24初始章程
文件上传工作组章程小组章程模板