网易首页 > 网易号 > 正文 申请入驻

MCP C# SDK 2.0默认无状态,会话握手被删了

0
分享至

微软宣布 MCP C# SDK 2.0 稳定版发布,实现的是 MCP 规范 2026-07-28 修订版。这一版把 Streamable HTTP 服务器改成默认无状态,统一了 HTTP 头,让基础设施能直接路由 MCP 流量,还引入了面向交互式工具的多轮往返请求(MRTR)。8 月到 10 月之间,2.1 到 2.3 三个小版本接连跟上。


MCP 是让应用向大模型提供上下文和工具的开放协议。C# SDK 由微软协作维护,构建在 ASP.NET Core 之上。SDK 团队把这次规范修订称为协议发布以来最大的一次,理由是它重新设计了 MCP 在 HTTP 上的工作方式。

握手没了,会话头也没了

initialize 握手和 Mcp-Session-Id 头被移除。协议版本和能力信息现在随每个请求一起走,任何服务器实例都能处理任何请求,不需要粘性路由,也不需要共享会话存储。

HttpServerTransportOptions.Stateless 默认值改为 true,需要会话的服务器把它设为 false。客户端先探测 server/discover,对老服务器回退到旧握手。只支持有状态的选项和旧 SSE 端点现在会抛出 MCP9006 和 MCP9004 警告。

tools/call 请求现在携带 Mcp-Method 和 Mcp-Name 头,[McpHeader] 特性可以把工具参数提升为 Mcp-Param-* 头。负载均衡器和网关因此能按头路由,不必读请求体。请求体仍是权威来源:头与体不一致时,服务器返回 HeaderMismatch 错误。

MRTR 补上交互缺口

无状态化去掉了服务器在调用中途向客户端要输入的通道,MRTR 用来替代它。工具抛出 InputRequiredException,附带一个或多个输入请求,用 InputRequest.ForElicitation、ForSampling 或 ForRootsList 构造,再加一个不透明的 requestState。客户端收集答案后带上 inputResponses 重新发起调用。注册了处理器时,McpClient 会自动完成这套流程。

在有状态会话下对接 2025-11-25 或更早的客户端,SDK 会桥接到旧的服务器发起请求方式;在无状态的降级连接上,该请求会以 McpException 形式暴露。Roots、sampling 和日志 API 按 SEP-2577 在 MCP9005 下标记弃用。

稳定的 1.x API 继续可用,例外是 Tasks:它移到了需要主动开启的 ModelContextProtocol.Extensions.Tasks 包,与 1.3、1.4 中的实验版本不兼容。实验性的 ModelContextProtocol.Extensions.Apps 包覆盖 MCP Apps。发布说明还列了更严格的 OAuth 行为:RFC 9207 签发者校验、强制声明 PKCE S256 支持、动态客户端注册中推断应用类型。包面向 .NET 8、9、10 以及 .NET Standard 2.0。

三个小版本各自补了什么

  • 2.1:新增可选的 subscriptions/listen 处理器,用于自定义服务端通知流;server/discover 在 HTTP 层失败时回退到 initialize。
  • 2.2:引入 HttpServerSessionMode,让使用 2025-11-25 和 2026-07-28 两个修订版的客户端共用一个端点;修复 McpHeaderEncoder.DecodeValue 的异常。
  • 2.3:McpClient.ServerInfo 改为可空,这是源码级破坏性变更,因为服务器可能从 server/discover 中省略可选的身份元数据;说明中警告不要用自报身份做安全决策。

现代 Streamable HTTP 响应现在会等到第一条协议消息再发送头,静默的长耗时处理器可能需要输出进度或调长 HTTP 超时。其他改动包括:列出工具、提示和资源时保留注册顺序;暴露 McpClientOptions.TimeProvider 以便做确定性的超时测试;把 OAuth 排除在 DiscoverProbeTimeout 之外;在等待优雅退出前先关闭 stdio 服务器的输入。

有读者在公告下提问:协议是否对 requestState 做了防篡改或跨会话复用的保护?评论区没有出现回复。

团队表示下一步重点是端到端认证与授权。SDK 已在 NuGet 上提供,项目站点有文档,GitHub 上有 2.0、2.1、2.2、2.3 的发布说明。

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
斯托克斯等人已在向火箭招手!太阳篮网送大礼,两大乐透秀确定了

斯托克斯等人已在向火箭招手!太阳篮网送大礼,两大乐透秀确定了

空谷幽幽蓝
2026-10-26 21:08:02
体制内外退休金的巨大差距引起老百姓的很大不满!

体制内外退休金的巨大差距引起老百姓的很大不满!

逍遥论经
2026-10-08 14:57:40
47岁廖碧儿认爱70岁百亿富商,5个前任全是富豪,陈豪当年没说错

47岁廖碧儿认爱70岁百亿富商,5个前任全是富豪,陈豪当年没说错

翰飞观事
2026-10-26 19:25:41
悲惨!因辅导作业,情绪失控,母女相继跳楼,双双坠亡!

悲惨!因辅导作业,情绪失控,母女相继跳楼,双双坠亡!

闲侃闲侃
2026-06-25 07:43:49
苹果iPad mini 7价格倒挂:官网卖6099元,二手市场2500元就能拿下

苹果iPad mini 7价格倒挂:官网卖6099元,二手市场2500元就能拿下

小8说科技
2026-10-26 12:01:00
又一电诈头目落网!坑害国人超27亿,杀人不眨眼,全网呼吁查赵薇

又一电诈头目落网!坑害国人超27亿,杀人不眨眼,全网呼吁查赵薇

泪满过眼
2026-10-10 07:24:15
户口本上最容易填错的一栏!“籍贯”不是老家,也不是出生地

户口本上最容易填错的一栏!“籍贯”不是老家,也不是出生地

坠入二次元的海洋
2026-10-18 18:37:48
大逆转?3细节暗示姆巴佩将拿金球奖:本人点头回应 佛爷破3年恩怨

大逆转?3细节暗示姆巴佩将拿金球奖:本人点头回应 佛爷破3年恩怨

风过乡
2026-10-26 20:02:46
抢救后换衣2分钟遭投诉解聘!监控证清白,医院仍开人:今天是她,明天是谁?

抢救后换衣2分钟遭投诉解聘!监控证清白,医院仍开人:今天是她,明天是谁?

医客
2026-10-25 12:10:20
拿破仑有个习惯很奇怪:他每天熬夜加班都要吃一只烤鸡,厨师整夜都不熄火

拿破仑有个习惯很奇怪:他每天熬夜加班都要吃一只烤鸡,厨师整夜都不熄火

言过于诚
2026-10-24 20:31:18
特朗普若干满这四年,就已经是两届;虽然中间隔了一届,但美国法律只允许总统任两届,隔一届也没用,美国宪法早就把这条路彻底堵死

特朗普若干满这四年,就已经是两届;虽然中间隔了一届,但美国法律只允许总统任两届,隔一届也没用,美国宪法早就把这条路彻底堵死

谈史论今1
2026-10-24 18:26:26
深圳肾衰竭妈妈摆摊随口一句“焦虑没有生意”被6岁儿子记在心上,自制“优惠券”招揽生意

深圳肾衰竭妈妈摆摊随口一句“焦虑没有生意”被6岁儿子记在心上,自制“优惠券”招揽生意

环球网资讯
2026-10-25 19:24:15
大幂幂不是白叫的

大幂幂不是白叫的

草莓解说体育
2026-10-24 07:40:22
令人崩溃!星巴克调整入座规则后,大批老人转场Manner坐满整店网传无一笔消费,座位之争再次引发热议

令人崩溃!星巴克调整入座规则后,大批老人转场Manner坐满整店网传无一笔消费,座位之争再次引发热议

火山詩话
2026-10-26 15:32:12
刷到网红四哥,真是让人哭笑不得,演了两年50亿富豪,连续4个月吃老坛酸菜面

刷到网红四哥,真是让人哭笑不得,演了两年50亿富豪,连续4个月吃老坛酸菜面

喜欢历史的阿繁
2026-10-18 01:39:26
鲁比奥:乌有充分的理由拒绝失去顿巴斯,因为这关系到国家的主权

鲁比奥:乌有充分的理由拒绝失去顿巴斯,因为这关系到国家的主权

阿纂看事
2026-10-25 17:10:23
有KTV的列车火了,客服:包厢点唱68元一小时,小包可容纳3人;车内还有棋牌室,收费80元一小时

有KTV的列车火了,客服:包厢点唱68元一小时,小包可容纳3人;车内还有棋牌室,收费80元一小时

大风新闻
2026-10-26 20:16:04
刘欢走了才敢讲!杀死他的并非股骨头坏死,而是明知红灯还硬扛!

刘欢走了才敢讲!杀死他的并非股骨头坏死,而是明知红灯还硬扛!

兵卒史
2026-10-21 18:12:10
无底线了!内塔尼亚胡之子被伊朗特工暗杀,弃行李连夜逃回以色列

无底线了!内塔尼亚胡之子被伊朗特工暗杀,弃行李连夜逃回以色列

梦史
2026-08-29 06:21:20
蛇冬眠的时候有多危险?一个专业捕蛇人坦言:90% 的人根本想不到,蛇进入冬眠,它就可能变成老鼠的一顿大餐

蛇冬眠的时候有多危险?一个专业捕蛇人坦言:90% 的人根本想不到,蛇进入冬眠,它就可能变成老鼠的一顿大餐

扶苏聊历史
2026-10-21 16:34:58
2026-10-26 22:32:49
碳基打工人
碳基打工人
坐标北京,靠咖啡续命,靠小红书下饭的普通人类。
210文章数 88关注度
往期回顾 全部

科技要闻

K3.1 Pro发布才两天,Kimi道歉补额度!

头条要闻

卢拉超级逆转第4次赢下大选后发声:巴西不是任何人后院

头条要闻

卢拉超级逆转第4次赢下大选后发声:巴西不是任何人后院

体育要闻

13年后重回诺坎普,穆里尼奥又滑跪了

娱乐要闻

胡歌杨幂刘诗诗袁弘陈龙结伴去埃及

财经要闻

卢锋:全球失衡背后 大国博弈与多边治理

汽车要闻

云辇-M上车 第二代海豹07让驾驶者也能爱上的家用车

态度原创

家居
本地
旅游
健康
亲子

家居要闻

2026建博会(广州) 公装联探展交流活动

本地新闻

这么近,那么美,周末赴贺州丨大湾区后花园

旅游要闻

节会引流带火“秋日经济”,临朐隐士村本土商户日销千斤柿饼

痘痘能根治吗?皮肤科医生说实话

亲子要闻

6个实操办法,让孩子彻底摆脱摆烂造作!

无障碍浏览 进入关怀版