写点什么

微软发布 MCP C# SDK 1.0 版本,全面支持最新的协议规范

作者:Almir Vuk
  • 2026-03-23
    北京
  • 本文字数:1069 字

    阅读完需:约 4 分钟

微软团队宣布推出其官方模型上下文协议(Model Context Protocol,MCP)C# SDK的 1.0 版本,全面支持2025-11-25版的 MCP 规范。

 

这个新版本为基于.NET 构建 MCP 服务器和客户端的开发者带来了多项重要功能。据悉,其中最值得关注的一个新增功能是增强型的授权服务器发现机制。

 

在更新后的规范中,服务器现在可以通过三种不同的方式暴露受保护资源元数据(Protected Resource Metadata),相比此前仅支持单一方式,灵活性得到了大幅提升。SDK 会在客户端自动处理完整的发现流程。

 

该版本还为工具、资源和提示词(prompts)添加了图标支持。开发者现在可通过简单的属性参数为这些组件分配图标,或配置更高级的选项,如多图标、MIME 类型、尺寸提示和主题偏好。服务器与客户端元数据也相应进行了扩展,以支持图标和网站 URL。

 

增量范围授权同意(Incremental scope consent)是该版本的另一项核心功能。它将最小权限原则应用到了 MCP 授权中,允许客户端仅请求每次操作所需的最小访问权限。

值得注意的是,此前客户端通常需要预先请求所有可能的权限。借助新机制,客户端可以先以最小范围的权限启动,并根据需要请求额外权限,SDK 会在客户端自动处理这一过程。

 

该版本还引入了URL模式引导(URL mode elicitation),使服务器能够将敏感交互(比如,API 密钥收集或第三方授权)完全从 MCP 客户端重定向至由服务器托管的安全 URL。据悉,这种方式可避免敏感数据通过客户端传输。

 

采样中的工具调用支持是技术层面最关键的新增功能之一。服务器现在可在采样请求中包含工具,允许语言模型在响应过程中调用这些工具。SDK 与Microsoft.Extensions.AI包的集成,简化了客户端和服务器端的实现流程。

 

该版本进一步纳入了OAuth客户端ID元数据文档(OAuth Client ID Metadata Documents,CIMDs),作为动态客户端注册(Dynamic Client Registration)的首选替代方案,并通过轮询机制改进了对 HTTP 长时间运行请求的支持,服务器可以关闭连接,客户端则能通过事件 ID 重新连接。

 

该版本的其他变更包括用于持久化状态跟踪的实验性 Tasks 支持、用于 SSE 流存储的 DistributedCacheEventStreamStore,以及扩展的 Implementation 元数据属性。

 

对于感兴趣的开发者,官方公告博客提供了该版本所有功能的详细实现步骤和代码示例,包括授权配置、图标设置、增量范围授权同意、引导处理、采样中的工具调用,以及长时间运行请求的管理。

 

此外,完整的发布说明和文档可在官方.NET开发者博客查阅,C# SDK 代码仓库托管在GitHub平台。

 

查看英文原文:Microsoft Launches MCP C# SDK v1.0, Bringing Full Support for Latest Protocol Specification