ModelContextProtocol TypeScript SDK 中无状态模式支持问题的分析与解决

在 ModelContextProtocol 的 TypeScript SDK 中，streamableHttp 模块存在一个关键的设计缺陷，导致无法正确支持无状态(stateless)模式。本文将深入分析该问题的技术背景、产生原因以及解决方案。

问题背景

在分布式系统架构中，特别是基于 Kubernetes 部署的服务场景下，无状态服务模式是常见的架构选择。这种模式下，服务实例不保存会话状态，每个请求都是独立处理的。ModelContextProtocol 的 TypeScript SDK 原本设计支持这种无状态模式，但在实际实现中存在逻辑缺陷。

技术细节分析

问题的核心在于 validateSession 方法的验证逻辑顺序不当。当前实现中，该方法首先检查服务器是否已初始化(this._initialized)，然后才检查是否处于无状态模式(this.sessionId === undefined)。这种顺序导致无状态模式下的请求总是被拒绝。

具体来说，在无状态模式下：

1. 服务器不会设置 sessionId
2. 每次请求都会创建新的传输实例
3. 由于没有复用机制，this._initialized 始终为 false
4. 验证逻辑因此失败，返回"Server not initialized"错误

影响范围

该缺陷主要影响以下使用场景：

• Kubernetes 集群部署的多实例服务
• 需要水平扩展的无状态服务架构
• 使用 JSON 响应模式的通信场景
• 不需要会话保持的短期交互应用

解决方案

正确的解决方案是调整验证逻辑的顺序，优先检查无状态模式。修改后的 validateSession 方法应该：

1. 首先检查是否处于无状态模式(sessionId 未定义)
2. 如果是无状态模式，直接通过验证
3. 否则继续执行现有的初始化状态检查

这种修改保持了原有功能的同时，正确支持了无状态模式。

实际应用建议

开发者在实现无状态服务时应注意：

• 明确设置 sessionIdGenerator 返回 undefined
• 根据需求选择启用 JSON 响应模式
• 确保每次请求都创建新的传输实例
• 正确处理可能的实例切换情况

该问题已在 1.10.1 版本中得到修复，开发者升级后即可正常使用无状态模式功能。