MCP 社区
文件上传工作组章程

文件上传工作组章程

社区译文；来源： MCP b491e568

小组类型

工作组

使命陈述

文件上传工作组负责定义 MCP 工具和 elicitation 请求如何声明文件输入，使宿主能够提供原生文件选择器，并将用户选择的文件内容传递给服务器。目前，需要用户提供文件的服务器只能使用文字说明，要求用户提交 base64 字符串或本地路径；这种做法会造成不一致的用户体验，并把编码细节推给最终用户。本 WG 将以 SEP-2356 为基础，规定用于声明文件输入的最小 schema 级机制，以及传递文件输入的线协议格式。

范围

范围内

  • 规范工作：通过 SEP 定义工具输入 schema 和 elicitation 请求 schema 中的声明式文件输入描述符、文件内容的线协议编码，以及宿主端处理要求。
  • 参考实现：为 FileInputDescriptor、data URI 编码提供 SDK 类型和辅助工具，并提供一个展示如何调用文件选择器和替换值的宿主流程示例。
  • 跨领域事项：与 MCP Apps WG 协调嵌入式 UI 表面自行提供文件选择器的场景，并与 Security WG 协调宿主端验证要求。
  • 文档：提供涵盖文件输入声明的规范章节，以及面向当前使用临时 base64 说明的服务器的迁移指南。

范围外

  • 服务器向客户端传递文件；该能力已由 Resources 和 BlobResourceContents 覆盖。
  • 更改传输层或会话模型。

WG 可以在设计工作中评估 streaming、chunked transfer 或 presigned upload URL 等方案；这些方案是进入初始 SEP 还是后续提案，由 WG 决定，而不是由本章程约束。

相关小组

  • MCP Apps WG — 嵌入式应用 UI 可以提供自己的文件选择器；描述符格式应能在该场景中复用。
  • Security WG — 用户提供的文件内容需要满足宿主端验证要求（SEP 引用 OWASP ASVS V5 作为通用上传安全卫生指南）。
  • Tool Annotations IG — 文件输入描述符是一种输入参数元数据，应与更广泛的 annotation 分类体系保持一致。

领导

角色姓名组织GitHub任期
LeadDen DelimarskyAnthropic@localden初始

本组由 Den Delimarsky（@localden）和 Nick Cooper（@nickcoai）发起支持。

权限与决策权

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

成员

姓名组织GitHubDiscord层级
Den DelimarskyAnthropic@localdenLead
Nick CooperOpenAI@nickcoaiWG Member
Olivier ChafikAnthropic@ochafikWG Member

运作方式

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

Discord：#file-uploads-wg

交付物与成功指标

活跃工作项

项目状态目标日期负责人
SEP-2356：声明式文件输入草案5 月底@ochafik
TypeScript SDK 参考实现—5 月底@ochafik
在第二个 Tier-1 SDK 中提供参考实现—6 月底待定

成功标准

  • 一份获接受的 SEP，定义文件输入描述符和线协议编码。
  • 至少两个 Tier-1 SDK 提供参考实现。
  • 至少一个生产宿主能根据描述符渲染原生文件选择器。
  • 新 schema 关键字具有 conformance 测试覆盖。

变更日志

日期变更
2026-04-23初始章程
为 MCP 作贡献文件系统工作组章程