我们很高兴地宣布 Spring AI MCP 0.4.0 里程碑版本发布。

仓库配置

将此 Spring 里程碑仓库添加到您的 POM

<repositories>
  <repository>
    <id>spring-milestones</id>
    <name>Spring Milestones</name>
    <url>https://repo.spring.io/libs-milestone-local</url>
    <snapshots>
      <enabled>false</enabled>
    </snapshots>
  </repository>
</repositories>

主要特性

参考文档：https://docs.springframework.org.cn/spring-ai-mcp/reference/overview.html

增强的根管理

• 在异步客户端中实现了正确的 ListRootsResult 包装
• 在服务器组件中添加了 listRoots 方法
• 在异步服务器中实现了根更改通知处理
• 添加了包含异步通知的根集成测试
• 添加了对单一和多个消费者根更改通知的支持
• 改进了根添加/删除场景的健壮性

改进的架构与文档

• 引入了 ClientMcpTransport 和 ServerMcpTransport 标记接口
• 使用适当的传输接口更新了客户端/服务器实现
• 重新组织了文档结构以提高清晰度
• 将文档图片迁移到 mcp-docs/antora 目录
• 更新了 README 文件，包含在线文档链接

服务器端能力

• 为 McpAsyncServer 和 McpSyncServer 添加了 createMessage 方法，用于 LLM 采样
• 在模型上下文协议 (MCP) 服务器中实现了客户端采样功能
• 使用默认构建器选项增强了服务器信息实现

Bug 修复与改进

• 修复了 toolsListRequestHandler 在处理 null 参数时潜在的 NullPointerException
• 改进了对未初始化客户端和缺失能力的处理
• 增强了跨多个组件的测试覆盖率

技术改进

• 添加了结构化日志支持，具有可配置的严重级别（从 DEBUG 到 EMERGENCY）
• 实现了日志消息通知
• 为客户端日志处理添加了日志消费者
• 扩展了日志功能的测试覆盖率

注意事项

• 文档已更新，以反映新特性和改进
• 进行了一些架构改进以增强可维护性