> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-zh.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 文件上传章程

> MCP 文件上传工作组的章程。

## 群组类型

**工作组**

## 使命陈述

文件上传工作组的存在是为了定义 MCP 工具和征询请求如何声明文件输入，从而使宿主能够呈现原生文件选择器并将用户选定的文件内容传递给服务器。如今，需要从用户处获取文件的服务器不得不诉诸文字说明，要求提供 base64 字符串或本地路径，这产生了不一致的用户体验，并把编码细节推给终端用户。本工作组将规定一种最小化的、schema 层的机制来声明文件输入，以及投递它们的线路格式，以 [SEP-2356](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2356) 为锚点。

## 范围

### 范围内

* **规范工作**：定义工具输入 schema 和征询请求 schema 上声明式文件输入描述符、文件内容的线路编码，以及宿主侧处理要求的 SEP。
* **参考实现**：面向 `FileInputDescriptor`、data URI 编码的 SDK 类型和辅助工具，以及一个演示选择器调用和值替换的示例宿主流程。
* **跨领域关切**：在嵌入式 UI 表面呈现其自身文件选择器之处与 MCP Apps 工作组协调，并就宿主侧验证要求与 Security 工作组协调。
* **文档**：涵盖文件输入声明的规范章节，以及面向当前使用临时 base64 说明的服务器的迁移指南。

### 范围外

* 服务器到客户端的文件投递，这已由资源和 `BlobResourceContents` 涵盖。
* 对传输层或会话模型的更改。

本工作组可以在其设计工作中评估诸如流式传输、分块传输或预签名上传 URL 之类的方法；这些是落地于初始 SEP 还是后续 SEP，属于 WG 决策而非章程约束。

### 相关群组

* **MCP Apps 工作组** —— 嵌入式应用 UI 可能呈现其自身的文件选择器；描述符格式应在该上下文中可复用。
* **Security 工作组** —— 针对用户提供文件内容的宿主侧验证要求（该 SEP 就一般上传卫生引用了 [OWASP ASVS V5](https://owasp.org/www-project-application-security-verification-standard/)）。
* **工具标注 IG** —— 文件输入描述符是一种输入参数元数据，应与更广泛的标注分类法保持一致。

## 领导层

| 角色   | 姓名             | 组织        | GitHub                                   | 任期 |
| ---- | -------------- | --------- | ---------------------------------------- | -- |
| Lead | Den Delimarsky | Anthropic | [@localden](https://github.com/localden) | 首任 |

由 Den Delimarsky（[@localden](https://github.com/localden)）和 Nick Cooper（[@nickcoai](https://github.com/nickcoai)）担保。

## 权限与决策权

| 决策类型           | 权限层级                    |
| -------------- | ----------------------- |
| 会议事务与排期        | WG Leads（自主）            |
| WG 内提案优先级排序    | WG Leads（自主）            |
| SEP 分诊与关闭（范围内） | WG Leads（自主，附成文理由）      |
| 范围内的技术设计       | WG 共识                   |
| 规范变更（增量式）      | WG 共识 → 核心维护者批准         |
| 规范变更（破坏性/根本性）  | WG 共识 → 核心维护者批准 + 更广泛评审 |
| 范围扩展           | 需要核心维护者批准               |
| WG 成员批准        | WG 成员担保                 |

## 成员

| 姓名             | 组织        | GitHub                                   | Discord | 级别    |
| -------------- | --------- | ---------------------------------------- | ------- | ----- |
| Den Delimarsky | Anthropic | [@localden](https://github.com/localden) |         | Lead  |
| Nick Cooper    | OpenAI    | [@nickcoai](https://github.com/nickcoai) |         | WG 成员 |
| Olivier Chafik | Anthropic | [@ochafik](https://github.com/ochafik)   |         | WG 成员 |

## 运作

| 会议   | 频率 | 时长    | 目的        |
| ---- | -- | ----- | --------- |
| 工作会议 | 双周 | 30 分钟 | 技术讨论、提案评审 |

Discord：`#file-uploads-wg`

## 交付物与成功指标

### 活跃工作项

| 条目                                                                                         | 状态    | 目标日期 | 牵头人                                    |
| ------------------------------------------------------------------------------------------ | ----- | ---- | -------------------------------------- |
| [SEP-2356：声明式文件输入](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2356) | Draft | 5 月底 | [@ochafik](https://github.com/ochafik) |
| TypeScript SDK 参考实现                                                                        | —     | 5 月底 | [@ochafik](https://github.com/ochafik) |
| 第二个 Tier-1 SDK 中的参考实现                                                                      | —     | 6 月底 | 待定                                     |

### 成功标准

* 一份定义文件输入描述符和线路编码的、已被接受的 SEP。
* 至少两个 Tier-1 SDK 中的参考实现。
* 至少一个生产宿主根据该描述符渲染出原生文件选择器。
* 针对新 schema 关键字的合规测试覆盖。

## 变更日志

| 日期         | 变更   |
| ---------- | ---- |
| 2026-04-23 | 首版章程 |