我們很高興地宣佈 Spring AI MCP 0.6.0 里程碑版本釋出。

重大變更 ⚠️

• McpClient.using() - 請改用 McpClient.sync() 或 McpClient.async()
• McpServer.using() - 請改用 McpServer.sync() 或 McpServer.async()
• McpServer.ToolRegistration - 請改用 McpServerFeatures.SyncToolRegistration 或 McpServerFeatures.AsyncToolRegistration
• McpServer.ResourceRegistration - 請改用 McpServerFeatures.SyncResourceRegistration 或 McpServerFeatures.AsyncResourceRegistration
• McpServer.PromptRegistration - 請改用 McpServerFeatures.SyncPromptRegistration 或 McpServerFeatures.AsyncPromptRegistration
• ToolHelper.toToolRegistration() - 請改用 ToolHelper.toSyncToolRegistration()

請遵循 0.6.0 遷移指南瞭解新的 API 變更。

主要特性與改進

協議版本協商

• 實現了 MCP 客戶端與伺服器之間的協議版本協商
• 在客戶端和伺服器中增加了對多個協議版本的支援
• 實現了當請求不支援的版本時回退到最新版本的機制
• 增加了對版本協商的全面測試覆蓋

可配置的 SSE 端點

• 在伺服器傳輸中使 SSE 端點路徑可配置
• 增加了對 WebFluxSseServerTransport、WebMvcSseServerTransport 和 HttpServletSseServerTransport 的定製支援
• 保持與預設 "/sse" 端點的向後相容性
• 使 Java SDK 的行為與 Python SDK 的 SseServerTransport 保持一致

錯誤修復 🐛

傳輸層改進

• 在傳輸層增加了入站處理的清理邏輯
• 增強了傳輸的可靠性和資源管理

改進與重構 🔧

API 重構

• 分離了非同步和同步客戶端互動
• 引入了新的客戶端建立模式

  // Synchronous client API
  McpClient.sync(transport).build();
  
  // Asynchronous client API
  McpClient.async(transport).build();
  

• 使 RequestHandler 能夠感知響應型別
• 棄用了舊版客戶端構建器模式

程式碼質量與結構

• 使 mcp-test 中的抽象測試與 mcp-core 對齊
• 改進了方法作用域定義
• 增強了程式碼組織和可維護性