Skip to main content

小组类型

工作组

使命宣言

文件上传工作组旨在定义 MCP 工具和引导请求如何声明文件输入,以便宿主能够呈现原生文件选择器,并将用户选定的文件内容传递给服务器。如今,需要从用户处获取文件的服务器往往会退而求其次,使用自然语言说明来要求提供 base64 字符串或本地路径,这会导致不一致的用户体验,并将编码细节推给最终用户。该工作组将基于 SEP-2356,为声明文件输入和交付这些输入的线格式制定一个最小的、schema 级别的机制。

范围

范围内

  • 规范工作:定义在工具输入 schema 和引导请求 schema 上声明式文件输入描述符的 SEP、文件内容的线格式编码,以及宿主侧处理要求。
  • 参考实现FileInputDescriptor 的 SDK 类型和辅助方法、data URI 编码,以及一个演示文件选择器调用和值替换的宿主流程示例。
  • 跨领域协作:与 MCP Apps WG 协调,以处理嵌入式 UI 自带文件选择器的场景;并与 Security WG 协调宿主侧验证要求。
  • 文档:覆盖文件输入声明的规范章节,以及面向当前使用临时 base64 指令的服务器的迁移指南。

范围外

  • 服务器到客户端的文件传递,这一部分已经由 Resources 和 BlobResourceContents 覆盖。
  • 对传输层或会话模型的更改。
作为设计工作的一部分,WG 可以评估流式传输、分块传输或预签名上传 URL 等方案;这些方案是落入初始 SEP 还是后续补充,由 WG 决定,而不是章程约束。

相关小组

  • MCP Apps WG — 嵌入式应用 UI 可能会呈现其自己的文件选择器;该描述符格式应在该场景中可复用。
  • Security WG — 针对用户提供的文件内容的宿主侧验证要求(该 SEP 参考了 OWASP ASVS V5 作为通用上传卫生规范)。
  • Tool Annotations IG — 文件输入描述符是一种输入参数元数据,且应与更广泛的注解分类保持一致。

领导层

由 Den Delimarsky(@localden)和 Nick Cooper (@nickcoai) 赞助。

权限与决策权

成员

运营

Discord: #file-uploads-wg

交付物与成功指标

进行中的工作项

成功标准

  • 一份已接受的 SEP,定义文件输入描述符和线格式编码。
  • 至少两个 Tier-1 SDK 中有参考实现。
  • 至少有一个生产环境宿主能够根据该描述符渲染原生文件选择器。
  • 新 schema 关键字具有一致性测试覆盖。

更新日志