modelcontextprotocol/java-sdk

解決的問題

提供一種標準化的方式，讓 Java 應用程式能夠整合 Model Context Protocol (MCP)，從而透過一致的介面與 AI 模型和工具進行互動。這消除了開發者為每個不同的 AI 工具或模型連接而建立自訂整合邏輯的需要。

工作原理

SDK 使用模組化架構實作 MCP 規範，支援同步與非同步通訊。它使用 Reactive Streams（透過 Project Reactor）來處理協定的雙向、非阻塞特性，同時為簡單用例提供同步封裝。在資料處理方面，使用 Jackson 進行 JSON 序列化，使用 JDK HttpClient 作為預設客戶端傳輸，同時使用 Jakarta Servlet 實作伺服器端傳輸。

適用對象

需要實作 MCP 客戶端（消費 AI 服務）或 MCP 伺服器（向 AI 模型暴露自身工具和資料）的 Java 開發者，用於建構 AI 驅動的應用程式。

主要亮點

• 彈性程式設計模型：支援反應式串流以滿足高效率非同步需求，同時提供同步 API 以簡化使用。
• 模組化設計：將核心邏輯與 JSON 繫結和傳輸實作分離，允許開發者僅包含必要的元件。
• 與 Spring AI 集成：透過 Spring Boot 啟動器、基於註解的方法處理以及 OAuth 2.0/API 金鑰安全機制擴充 SDK 功能。
• 傳輸無關性：預設支援 STDIO、JDK HttpClient 和 Servlet，但對其他實作（如 Netty 或 Vert.x）保持開放。