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

# SEP 指南

> 模型上下文协议规范增强提案 (SEP) 指南，用于提出对协议的变更

## 什么是 SEP？

SEP 代表规范增强提案。SEP 是为 MCP 社区提供信息或描述模型上下文协议新功能的文档，或描述其流程或环境的文档。SEP 应提供功能的简洁技术规范和功能的理由。

我们希望 SEP 成为提议主要新功能、收集社区对问题的输入以及记录 MCP 设计决策的主要机制。SEP 作者负责在社区内建立共识并记录不同意见。

由于 SEP 作为版本化仓库（GitHub Issues）中的文本文件维护，它们的修订历史是功能提案的历史记录。

## 什么符合 SEP？

目标是为需要广泛社区讨论、正式设计文档和决策过程历史记录的重大变更保留 SEP 流程。常规 GitHub issue 或拉取请求通常更适合较小、更直接的变更。

如果您的变更涉及以下任何一项，请考虑提议 SEP：

* **新功能或协议变更**：任何添加、修改或移除模型上下文协议中的功能。这包括：
  * 添加新的 API 端点或方法。
  * 更改现有数据结构或消息的语法或语义。
  * 引入不同 MCP 兼容工具之间互操作性的新标准。
  * 对规范本身的定义、呈现或验证的重大变更。
* **破坏性变更**：任何不向后兼容的变更。
* **治理或流程变更**：任何改变项目决策制定、贡献指南（像本文档本身）的提案。
* **复杂或有争议的话题**：如果变更可能有多个有效解决方案或产生重大辩论，SEP 流程提供了探索替代方案、记录理由和在实施开始前建立社区共识的必要框架。

## SEP 类型

有三种 SEP：

1. **标准跟踪** SEP 描述模型上下文协议的新功能或实现。它还可以描述将在核心协议规范之外支持的互操作性标准。
2. **信息性** SEP 描述模型上下文协议设计问题，或为 MCP 社区提供一般指南或信息，但不提议新功能。信息性 SEP 不一定代表 MCP 社区共识或推荐。
3. **流程** SEP 描述围绕 MCP 的流程，或提议对流程的变更（或流程中的事件）。流程 SEP 类似于标准跟踪 SEP，但适用于 MCP 协议本身以外的领域。

## 提交 SEP

SEP 流程从模型上下文协议的新想法开始。强烈推荐单个 SEP 包含单个关键提案或新想法。小增强或补丁通常不需要 SEP，可以通过拉取请求注入到 MCP 开发工作流中。SEP 越聚焦，往往越成功。

每个 SEP 必须有**SEP 作者**——使用下面描述的样式和格式编写 SEP、在适当论坛中引导讨论并尝试围绕想法建立社区共识的人。SEP 作者应首先尝试确定想法是否适合 SEP。在 MCP 社区论坛（Discord、GitHub Discussions）发布是最好的方式。

### SEP 工作流

SEP 应作为 [规范仓库](https://github.com/modelcontextprotocol/specification) 中的 GitHub Issue 提交。 标准 SEP 工作流是：

1. 您，SEP 作者，使用 `SEP` 和 `proposal` 标签创建一个[格式良好的](#sep-format) GitHub Issue。SEP 编号与 GitHub Issue 编号相同，两者可以互换使用。
2. 找到核心维护者或维护者来赞助您的提案。核心维护者和维护者将定期检查开放提案列表以确定要赞助哪些提案。您可以在提案中标记[维护者列表](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/MAINTAINERS.md)中的相关维护者。
3. 一旦找到赞助者，GitHub Issue 被分配给赞助者。赞助者将添加 `draft` 标签，确保 SEP 编号在标题中，并分配里程碑。
4. 赞助者将非正式审查提案，并可能根据社区反馈请求变更。当准备好进行正式审查时，赞助者将添加 `in-review` 标签。
5. 添加 `in-review` 标签后，SEP 进入核心维护者团队的正式审查。SEP 可能被接受、拒绝或退回修订。
6. 如果 SEP 在三个月内未找到赞助者，核心维护者可能会将其关闭为 `dormant`。

### SEP 格式

每个 SEP 应有以下部分：

1. **序言** -- 一个简短描述性标题，每个作者的姓名和联系信息，当前状态。
2. **摘要** -- 对正在解决的技术问题的简短（\~200 字）描述。
3. **动机** -- 动机应清楚解释为什么现有协议规范不足以解决 SEP 解决的问题。对于想要改变模型上下文协议的 SEP，动机至关重要。没有足够动机的 SEP 提交可能会被直接拒绝。
4. **规范** -- 技术规范应描述任何新协议功能的语法和语义。规范应足够详细以允许竞争性、互操作性实现。应提供对规范的变更的 PR。
5. **理由** -- 理由解释为什么做出特定设计决策。它应描述考虑的替代设计和相关工作。理由应提供社区内共识的证据，并讨论讨论期间提出的重要反对意见或担忧。
6. **向后兼容性** -- 所有引入向后不兼容的 SEP 必须包含描述这些不兼容及其严重性的部分。SEP 必须解释作者提议如何处理这些不兼容。
7. **参考实现** -- 参考实现必须在任何 SEP 被赋予"最终"状态之前完成，但它不需要在 SEP 被接受之前完成。虽然在编写代码之前就规范和理由达成共识的方法有其优点，但"粗略共识和运行代码"的原则在解决许多协议细节讨论时仍然有用。
8. **安全影响** -- 如果 SEP 存在安全担忧，这些担忧应明确写出以确保 SEP 的审查者意识到它们。

### SEP 状态

SEP 可以是以下状态之一

* `proposal`：没有赞助者的 SEP 提案。
* `draft`：有赞助者的 SEP 提案。
* `in-review`：准备审查的 SEP 提案。
* `accepted`：核心维护者接受的 SEP，但仍需要最终措辞和参考实现。
* `rejected`：核心维护者拒绝的 SEP。
* `withdrawn`：撤回的 SEP。
* `final`：最终化的 SEP。
* `superseded`：已被较新 SEP 替换的 SEP。
* `dormant`：未找到赞助者随后关闭的 SEP。

### SEP 审查和解决

SEP 由 MCP 核心维护者团队每两周审查一次。

要接受 SEP，它必须满足某些最低标准：

* 演示提案的原型实现
* 对 MCP 生态系统的明确益处
* 社区支持和共识

一旦 SEP 被接受，必须完成参考实现。当参考实现完成并纳入主源代码仓库时，状态将更改为"最终"。

SEP 也可以被"拒绝"或"撤回"。被"撤回"的 SEP 可以在以后重新提交。

## 报告 SEP 错误或提交 SEP 更新

您报告错误或提交 SEP 更新的方式取决于几个因素，例如 SEP 的成熟度、SEP 作者的偏好以及您的评论性质。对于尚未达到 `final` 状态的 SEP，最好直接将您的评论和变更发送给 SEP 作者。一旦 SEP 最终确定，您可能希望将更正作为 GitHub 评论提交到 issue 或对参考实现的拉取请求。

## 转让 SEP 所有权

偶尔需要将 SEP 的所有权转让给新的 SEP 作者。一般来说，我们希望保留原作者作为转让 SEP 的共同作者，但这真的取决于原作者。转让所有权的一个好原因是原作者不再有时间或兴趣更新它或遵循 SEP 流程，或已从网上消失（即无法联系或不回复电子邮件）。转让所有权的一个坏原因是您不同意 SEP 的方向。我们尝试围绕 SEP 建立共识，但如果不可能，您总是可以提交竞争性 SEP。

## 版权

本文档置于公共领域或 CC0-1.0-Universal 许可证下，以更宽松者为准。