微软团队宣布发布了其官方Model Context Protocol(MCP)的1.0版本C# SDK。这一新版本全面支持2025年11月25日发布的MCP规范。

新版本为那些使用.NET框架开发MCP服务器和客户端的开发者带来了多项重要功能。其中最值得关注的一项改进是授权服务器发现机制的优化。

根据更新后的规范,服务器现在可以通过三种不同的方式来提供受保护的资源元数据,这比之前所需的单一方法提供了更大的灵活性。SDK会自动在客户端完成整个发现过程。

此外,新版本还为工具、资源和提示信息添加了图标支持。开发者可以通过简单的属性参数为这些组件设置图标,或者配置更高级的选项,比如使用多个图标、指定MIME类型、调整图标大小以及选择主题风格。服务器和客户端的元数据也得到了扩展,现在也可以包含图标和网站URL信息。

“渐进式权限范围控制”也是此次发布的另一个重要功能。这一机制遵循最小权限原则,允许客户端仅请求完成特定操作所需的最小权限。

以前,客户端通常需要事先申请所有可能的权限。而新机制下,客户端会先使用最低权限范围进行操作,然后根据实际需求再申请额外的权限;SDK会在客户端自动处理这些权限申请流程。

此外,还引入了“URL模式请求机制”。通过这种机制,服务器可以将涉及敏感信息的操作(如API密钥的获取或第三方授权流程)完全转移到安全的服务器端进行处理,从而避免敏感数据通过客户端进行传输。

在采样功能中加入对工具的支持也是此次更新的重要内容。现在,服务器可以在采样请求中包含相关工具,这样语言模型在生成响应时就可以调用这些工具。SDK与Microsoft.Extensions.AI包的集成,使得在客户端和服务器端的实现都变得更加简单。

新版本还提供了OAuth客户端ID元数据文档,作为动态客户端注册机制的替代方案;同时,通过轮询机制改进了对长时间运行的HTTP请求的支持,这使得服务器可以及时关闭连接,而客户端则可以通过事件ID重新建立连接。

此次发布的其他变更还包括:为实现持久状态跟踪而提供的实验性功能、用于存储SSE流数据的`DistributedCacheEventStreamStore`,以及经过扩展的`Implementation`元数据属性。

对于感兴趣的开发人员来说,官方公告博客中提供了关于此次发布所包含的各项功能的详细实现步骤和代码示例,这些内容涵盖了授权配置、图标设置、增量范围同意机制、数据采集处理流程、采样时所需的工具调用方式,以及长时间运行的请求管理方法等。

此外,完整的发布说明和文档可以在官方的.NET开发者博客上找到,而C# SDK代码库则托管在GitHub平台上。

Comments are closed.