- 状态(Status): Final
- 类型(Type): Standards Track
- 创建时间(Created): 2026-02-03
- 作者(Author(s)): Mark D. Roth (@markdroth), Caitie McCaffrey (@CaitieM20), Gabriel Zimmerman (@gjz22)
- 发起人(Sponsor): Caitie McCaffrey (@CaitieM20)
- PR: https://github.com/modelcontextprotocol/specification/pull/{2322}
摘要(Abstract)
本提案规定了一种简单的方式,在客户端发起请求的上下文中处理服务器发起的请求(例如工具调用上下文中的一次征询请求),无需跨服务器实例共享的存储层,也无需负载均衡中的有状态性。这将在常见情形下显著降低大规模运营 MCP 服务器的成本。它还减少了 HTTP 传输对 SSE 流的依赖——SSE 流在许多无法支持长连接的环境中会带来问题。 这种处理服务器发起请求的方式将取代当前发送服务器发起请求的做法。这是一项破坏性变更。 本 SEP 还规定了服务器可以在其上发送服务器发起请求的客户端请求子集。相较于当前规范,这缩小了范围,同样是一项破坏性变更。 在此做出破坏性变更是必要的,因为对于许多远程 MCP 服务器或服务器托管客户端而言,由于支持 SSE 流和服务端状态所带来的运维复杂度,征询(Elicitation)、采样(Sampling)与 ListRoots 等服务器发起请求特性的采用率非常低或被阻断。动机(Motivation)
注意:本 SEP 旨在为在任意客户端发起请求的上下文中处理任意服务器发起请求提供一种通用机制。为清晰起见,本文档全程会具体以工具调用作为任意客户端发起请求的代表来讨论,但应理解为同样适用于(例如)资源或提示请求;同样,我们会以征询请求作为任意服务器发起请求的代表来讨论,但应理解为同样适用于(例如)采样请求。 我们从一个观察出发:MCP 工具有两种类型:- 临时型(Ephemeral):服务端不累积任何状态。
- 若服务器需要更多信息来处理工具调用,它可以在拿到附加信息后从头开始。
- 示例:天气应用、访问电子邮件
- 持久型(Persistent):服务端累积状态。
- 服务器在向客户端请求更多信息之前,可能已生成大量状态,并且在收到信息后可能需要取回该状态以继续处理。
- 服务器可能需要在等待客户端提供更多信息时于后台继续处理,此时需要服务端状态来跟踪该正在进行的处理。
- 示例:访问一个 agent、启动一台 VM 并需要用户交互来操作该 VM
- 客户端发送工具调用请求。在此示例中,我们假设负载均衡器恰好把该请求发给服务器实例 A。
- 服务器 A 打开一条 SSE 流,并在该流上发送征询请求。
- 客户端将征询响应作为一个独立的请求发送,负载均衡器会完全独立于第 1 步的选择来选择服务器实例。在本示例中,我们假设负载均衡器恰好把该请求发给服务器实例 B。
- 服务器 A 必须以某种方式发现被投递到服务器 B 的征询响应。
- 服务器 A 随后在第 2 步打开的 SSE 流上发送工具调用结果。
- 跨服务器实例共享的持久存储层:服务器可以部署并管理一个持久存储层(例如 PostgreSQL、Redis、DynamoDB),使多个服务器实例能够把一个实例上的征询响应与另一个实例上原始正在进行的工具调用匹配。此途径有若干缺点:
- 持久存储层 极其昂贵,尤其对于本来可能并不具备此类层的临时型工具(例如天气工具)而言。
- 持久存储层带来显著的可靠性顾虑:它成为关键依赖,因而是潜在的单点故障。为避免这一点,它必须提供高可用、复制与备份机制。
- 持久存储层成为瓶颈,限制水平扩展性。地理分布则需要昂贵的全局复制或粘性路由。
- 持久存储层还带来显著的运维复杂度。在水平扩展的部署中,它需要分布式锁或共识协议。它还需要特殊的垃圾回收逻辑来判断何时可以清理共享状态,而这需要谨慎权衡:过于激进地清理状态能降低存储成本但会限制用户响应的时间窗口,而清理不够激进则能容纳慢速用户但会增加存储成本。
- 此途径要求工具实现具备与持久存储层集成的特殊行为。如今的 MCP SDK 并没有针对此类存储层集成的特殊钩子,这意味着通过 SDK 内联编写代码非常困难。
- 负载均衡中的有状态性:借助 cookie,负载均衡层有可能确保第 3 步中的征询请求被投递到与第 1 步原始请求相同的服务器实例。此途径虽通常比持久存储层便宜,但有以下缺点:
- 它需要负载均衡器中的特殊配置与行为,通常难以管理。
- 它破坏了正常的负载均衡模型,导致负载分布不均,从而增加运行服务的成本。
- 它需要客户端具备传播用于有状态性的 cookie 的特殊行为。
- 它要求工具实现把征询请求与正在进行的工具调用匹配起来。(MCP SDK 有一些处理此事的代码,但在 HTTP 世界中这仍是一种非常奇怪的模式。)
- 它不具备容错性。若服务器实例宕机,所有状态都会丢失,工具调用将不得不从头开始。(这对临时型工具未必要紧,但对持久型工具是个问题。)
规范(Specification)
本 SEP 提出一种在客户端请求上下文中处理服务器请求的新机制。这一新机制在临时型工具与持久型工具上有略微不同的工作流,后者将利用 Tasks。不过,两种工作流都使用相同的数据结构。Schema 变更
首先,我们引入InputRequests 的概念,它表示一组一个或多个待发送给客户端的服务器发起请求;以及 InputResponses,它表示客户端对这些请求的响应。请求和响应都存储在以字符串为键的 map 中。对于 InputRequests,map 值是服务器发起的请求(例如征询或采样请求),而对于 InputResponses,map 值是对这些请求的响应。以下是在 TypeScript MCP schema 中的样子:
tools/call 等方法调用创建了一个多态响应,我们向 Result 引入一个新字段来指示 ResultType。客户端应解析该字段以确定消息中所含 Result 的类型。若未提供该字段,客户端应为向后兼容假定 ResultType 为 "complete"。
扩展 可以(MAY) 添加额外的 ResultType 值。所支持的 ResultType 值集合 必须(MUST) 由核心协议中定义的集合构建而来,并包含经能力(capabilities)广告的所支持扩展的任何附加值。
客户端 应当(SHOULD) 将无法识别的值视为无效的协议响应。
schema 变更如下所示:
tasks。
这些类型将用于两个不同的工作流,一个用于临时型工具,另一个用于持久型工具。
客户端请求的服务器发起请求支持
许多ClientRequest 并没有明确的用例需要服务器向客户端请求更多信息。本 SEP 在 SEP-2260 的基础上,进一步限制服务器何时可以向客户端发送服务器发起请求。
服务器 可以(MAY)在以下客户端请求上发送 InputRequiredResult 响应:
服务器 必须(MUST NOT)不在任何其他客户端请求上发送
InputRequiredResult 响应。下表列出撰写本 SEP 时这排除了哪些 ClientRequest。
临时型工具工作流
对于临时型用例,除了输入请求之外,我们引入请求状态(request state)的概念。在服务器需要更多信息的情况下,请求状态被发送给客户端,客户端将该状态回传给服务器,从而让服务器保持无状态。 我们将为临时型工具采用以下工作流:- 客户端发送工具调用请求。
- 服务器回送单个响应,指示该请求未完成。该响应可能包含客户端必须完成的输入请求。它也可能包含客户端必须回传给服务器的某些请求状态。该响应终止原始请求。它通常将作为单个响应发送,而非在 SSE 流上发送,尽管就目前而言(这可能在未来的 SEP 中改变)在(例如)进度通知之后于 SSE 流上发送该响应也是合法的。若这个未完成响应在 SSE 流上发送,它必须是该 SSE 流上的最后一条消息,正如它是一个普通响应一样。
- 客户端发送一个全新的工具调用请求,与原始请求完全独立。该新工具调用包含对第 2 步输入请求的响应。它还包含服务器在第 2 步指定的请求状态。
- 服务器回送一个 CallToolResponse。
临时型工作流的真实世界示例
本示例演示requestState 如何支持由 Azure DevOps 自定义规则驱动的多轮往返征询流程。该场景涉及一个 update_work_item 工具,将一个 Bug 工作项转换为 “Resolved”。ADO 自定义规则要求在发生某些状态转换时提供特定字段,服务器使用迭代式征询来收集它们——跨多轮在 requestState 中累积上下文,从而无需任何服务端存储即可执行最终更新。
请求状态的用例
“requestState” 机制提供了在同一逻辑请求上进行多轮往返的手段。主要有两个用例。用例 1:滚动升级
假设你正在对水平扩展的服务器实例进行滚动升级,以部署工具实现的新版本。旧版本有两个输入请求,键为 “github_login” 和 “google_login”。然而在工具实现的新版本中,它仍然使用 “github_login” 输入请求,但用一个新的 “microsoft_login” 输入请求替换了 “google_login” 输入请求。 如果第一个请求命中运行旧版本的服务器,而第二次尝试(包含输入响应)命中运行新版本的服务器,那么服务器将看到它需要的 “github_login” 结果,但看不到 “microsoft_login” 的结果。(它也会看到 “google_login” 的结果,但它不再需要该结果,故无关紧要。)此时服务器需要为 “microsoft_login” 发送一个新的输入请求,但它也不想丢失已经拿到的 “github_login” 答案,因此它会使用 1685 中提出的那种状态来保留该信息,而无需在服务端存储状态。 此处的工作流如下:- 客户端发送工具调用请求,命中运行旧版本的服务器实例。
- 服务器回送一个未完成响应,指示 “github_login” 和 “google_login” 的输入请求。
- 客户端发送一个新的工具调用请求,包含对 “github_login” 和 “google_login” 输入请求的响应。这次它命中运行新版本的服务器实例。
- 服务器回送另一个未完成响应,指示客户端尚未提供的 “microsoft_login” 输入请求。然而,该响应还包含含有已提供的 “github_login” 响应的请求状态,以便客户端无需再次向用户询问同样的信息。
- 客户端发送第三个工具调用请求,包含对 “microsoft_login” 输入请求的响应,并回传服务器在第 4 步提供的请求状态。
- 服务器现在在请求状态中看到 “github_login” 信息、在输入响应中看到 “microsoft_login” 状态,因此该请求现在包含服务器执行工具调用并回送完整响应所需的一切。
用例 2:卸载负载(Load Shedding)
假设你有一个 MCP 服务器实例正在处理一批工具调用,并注意到自己负载过重,因此想把其中一个正在进行的工具调用迁移到另一个服务器实例。然而,它已经在该工具调用上完成了大量处理,因此它不想简单地使调用失败、让客户端在另一个服务器实例上从头开始;相反,它想保留已累积的状态,以便无论哪个服务器实例恢复处理都能从原始服务器实例停下的地方继续。这可以通过发送一个包含请求状态但不包含任何输入请求的未完成请求来实现。 此处的工作流如下:- 客户端发送原始请求,负载均衡器将其路由到服务器实例 A。
- 服务器实例 A 做了大量计算后决定需要卸载负载。它发送一个未完成响应,在
requestState字段中含有其累积的状态,但不含inputRequests字段。 - 客户端带着
requestState字段重试请求。负载均衡器将该请求路由到服务器实例 B。 - 服务器实例 B 从它在
requestState字段中看到的状态开始,从而从服务器实例 A 停下的地方接续计算,并最终返回一个完整响应。
临时型工作流的协议要求
-
服务器行为:
- 服务器 可以(MAY)以
InputRequiredResult响应任何客户端发起的请求。该消息 可以(MAY)作为独立响应发送,或作为 SSE 流上的最后一条消息发送,不过鼓励实现优先选择前者。若使用 SSE 流,服务器 必须(MUST NOT)不在未完成响应消息之后于流上发送任何消息。 InputRequiredResult可以(MAY)包含inputRequests字段。InputRequiredResult可以(MAY)包含requestState字段。若指定,该字段是一个仅对服务器有意义的不透明字符串。服务器可以自由地以任意格式编码该状态(例如纯 JSON、base64 编码的 JSON、加密的 JWT、序列化的二进制等)。- 若请求包含
requestState字段,服务器 必须(MUST)始终校验该状态,因为客户端是不可信的中间方。若担心被篡改,服务器 应当(SHOULD)使用其选择的加密算法(例如可使用 AES-GCM 或签名的 JWT)加密requestState字段,以确保机密性与完整性。请注意,还存在重放/劫持攻击的风险,即已认证的攻击者重发原本发给另一个用户的状态。因此,若请求状态包含任何特定于原始用户的数据,服务器 必须(MUST)使用某种机制将数据以密码学方式绑定到原始用户,并 必须(MUST)验证客户端发送的requestState数据与当前已认证用户相关联。使用明文状态的服务器 必须(MUST)将解码后的值视为不可信输入,并像校验任何客户端提供的数据一样校验它们。
- 服务器 可以(MAY)以
-
客户端行为:
- 若客户端收到
InputRequiredResult消息,且该消息包含inputRequests字段,则客户端 必须(MUST)在重试原始请求之前构造所请求的输入。相反,若该消息 不 包含inputRequests字段,则客户端 可以(MAY)立即重试原始请求。 - 若客户端收到包含
requestState字段的InputRequiredResult消息,它 必须(MUST)在重试原始请求时回传该字段的确切值。客户端 必须(MUST NOT)不检查、解析、修改或对requestState内容做任何假设。若InputRequiredResult不包含requestState字段,客户端 必须(MUST NOT)不在重试中包含它。
- 若客户端收到
持久型工具工作流
持久型工具工作流将利用 Tasks。Tasks 已经提供了一种机制来指示需要更多信息才能完成请求。input_required Task 状态允许服务器指示需要额外信息才能完成对任务的处理。
Tasks 的工作流如下:
- 服务器将 Task 状态设为
input_required。服务器此时可以暂停处理请求。 - 客户端通过调用
tasks/get取回 Task 状态,看到需要更多信息。 - 客户端调用
tasks/result。 - 服务器返回
InputRequests对象。 - 客户端发送
tasks/input_response请求,其中包含InputResponses对象以及Task元数据字段。 - 服务器恢复处理,将 TaskStatus 设回
working。
Tasks 很可能运行时间较长、关联有状态且计算成本较高,请求更多信息并不会终结原本请求的操作(例如工具调用)。相反,一旦提供了必要信息,服务器可以恢复处理。
为与 MRTR 语义保持一致,服务器将以 InputRequests 对象响应 tasks/result 请求。两者将具有相同的 JsonRPC id。当客户端以 InputResponses 对象响应时,这是一个带有新 JSONRPC id 的新客户端请求,因此需要一个新的方法名。我们提议 tasks/input_response。
上述工作流及下方示例均未利用任何可选的 Task 状态通知,尽管本 SEP 并不排斥使用它们。
持久型工作流的协议要求
-
服务器行为:
- 服务器 可以(MAY)通过指示任务处于
input_required状态来响应tasks/get。 - 当任务处于
input_required状态时,服务器 必须(MUST)在tasks/result响应中包含inputRequests字段。
- 服务器 可以(MAY)通过指示任务处于
-
客户端行为:
- 当
tasks/get显示状态为input_required时,客户端 必须(MUST)调用tasks/result以获取输入请求。客户端 应当(SHOULD)构造这些请求的结果,然后调用tasks/input_response携带输入响应来为任务提供所需输入。 - 客户端 可以(MAY)选择不满足这些输入请求,此时它们可以取消任务。
- 当
临时型与持久型工作流之间的交互
如果某个工具实现需要客户端先响应一组输入请求才能开始处理,但之后又需要进行持久处理,它可以先使用临时型工作流,然后在那个点创建一个任务,从而切换到持久型工作流。这避免了服务器在真正拥有开始处理请求所需信息之前就必须存储状态。此工作流如下:- 客户端发送带任务元数据的工具调用请求。
- 服务器回送
inputRequests响应,指示需要更多信息来处理请求。这会终止原始请求。 - 客户端发送一个全新的工具调用请求,与原始请求完全独立,包含
inputResponses对象以及任务元数据。 - 服务器回送一个任务 ID,指示它将在后台处理请求。所有后续交互都将通过 Tasks API 完成。
错误处理指引
本节为客户端在inputResponses 对象中提供意料之外或格式错误数据的场景提供错误处理的实现指引。
与任何收到的请求一样,服务器 应当(SHOULD)校验客户端提供的数据是有效的 inputResponses 对象,且其中的信息可被正确解析。诸如格式错误的 JSON、无效 schema 或阻止请求处理的内部服务器错误等协议错误,应返回带有适当错误码与消息的 JSONRPCErrorResponse。
若 inputResponses 对象中提供了额外参数,服务器 应当(SHOULD)将其视为可选参数。因此,它 应当(SHOULD)忽略 inputResponses 对象中它无法识别或不需要的任何意料之外的信息。
客户端也可能未发送先前 inputRequests 中请求的全部信息。若缺失的被请求信息是服务器处理请求所必需的,则它 应当(SHOULD)以一个新的 InputRequiredResult 响应。
我们讨论过返回一个特定的应用级错误码,然而客户端在所有场景下未必有足够信息来恢复。因此,我们决定依赖通过 InputRequiredResult 请求更多输入的既有机制,以确保客户端总能通过让服务器再次请求必要信息来恢复。
恶意客户端可能故意在 inputResponses 对象中发送错误信息,并通过令服务器反复请求同样的信息来在服务器上产生负载。然而,这并非本工作流引入的新顾虑,因为恶意客户端本就可以通过发送格式错误的请求来产生负载。服务器实现者可以使用限流、节流等标准技术来保护自己免受此类攻击。
在临时型工作流中,这将如下所示:
- 客户端重试原始工具调用,这次包含
inputResponses对象,但响应缺少服务器处理请求所需的必要信息。
- 服务器以一个未完成响应回复,指示客户端需要响应一次征询请求才能使工具调用完成,并包含待回传的请求状态:
- 服务器以一个未完成响应回复,指示客户端需要提供缺失的信息才能使请求成功。
JSONRPCResultResponse 确认收到响应。然而,由于该响应缺少必需信息,服务器不继续处理任务,并将 Task 状态保持为 input_required。下次客户端调用 tasks/result 时,服务器以一个新的 inputRequest 响应,再次请求必要信息。
理由(Rationale)
我们曾考虑用一种双向流方式取代 SSE 流。然而,那种方式会使线协议更复杂(例如它会要求 HTTP/2 或 HTTP/3)。此外,它既不会消除无法支持长连接环境的问题,也不会解决容错问题。 关于输入请求应是一个 map 还是仅一个单一对象、也许利用请求内部的某个字段(例如征询 ID)来区分它们,曾有过讨论。我们判定 map 是合理的,因为它在结构上保证了键的唯一性,从而避免了 SDK 与应用中为避免冲突而进行显式检查的需要。 在持久型工作流中,我们曾考虑将输入请求直接包含在tasks/get 响应中,而不要求客户端看到 input_required 状态后再调用 tasks/result 获取输入请求。我们决定将这两件事分开,以照顾那些为任务状态与实际工具实现使用独立基础设施的实现;其思路是 tasks/get 调用应具有一致的时延特征,无论任务状态实际如何。我们认识到这需要向服务器多一次往返,但若此成为问题,我们可以在未来优化。
向后兼容性(Backward Compatibility)
如今许多 SDK 以内联但异步的方式支持征询,即在原始 SSE 流上发送工具调用响应之前等待征询响应,这对于单进程或能确保请求粘性路由的 MCP 服务器有效。安全影响(Security Implications)
由于requestState 会经过客户端,恶意或被攻陷的客户端可能试图修改它以改变服务器行为、绕过授权检查或破坏服务器逻辑。为缓解这一点,我们要求服务器按上文协议要求所述校验该状态。