Google 的 MCP Toolbox for Databases Java 用戶端於 9 月 9 日達到 1.0.0 版。在 10 月 6 日的 公告中，該公司說明了傳輸、驗證與工具參數的變更，供將 Java 應用程式連接至獨立執行 Toolbox 伺服器的團隊參考。 版本紀錄 顯示程式碼發布時間比該公告早了將近一個月。

對正在考慮是否採用此用戶端的 Java 團隊而言，這項差異很重要。Google 稱 1.0 是穩定且向後相容的基礎，但同一份版本紀錄也列出一項破壞性變更：提供給代理程式的工具定義會移除綁定參數。既有整合在升級前應檢查自己如何使用這些定義。Google 的 儲存庫 也指出 Java 功能支援仍在開發中，尚未達到 Python、JavaScript/TypeScript 與 Go SDK 的程度。

重大變化

1.0 用戶端為 Java 應用程式提供明確方式，以探索並呼叫 MCP Toolbox 提供的工具。新增的 HttpMcpTransport 位於傳輸介面之後，而 CredentialsProvider 與 AuthMethods 則將憑證解析和用戶端分開。Google 表示，每次請求都會非同步解析憑證。此版本還新增預設參數值、HTTP 憑證暴露警告、版本選擇、工作階段追蹤，以及自訂請求標頭的對照表。這些是 SDK 文件所載功能，並非 BIG CHANGE 的效能或安全測試。

Toolbox 本身是獨立伺服器。操作人員會為其設定資料來源與工具；Java 用戶端連線至該伺服器的 URL、載入工具定義並送出呼叫。僅新增 Java 相依套件並不會設定資料庫、授予權限或部署伺服器。 官方 Java 文件 說明了用戶端與伺服器的角色，而 SDK 儲存庫 要求在設定用戶端前先啟動伺服器。

Java 團隊可以評估的事項

以下步驟取自 Google 的文件與儲存庫。BIG CHANGE 未執行程式碼，也未連線至資料庫。

  1. 準備獨立的 Toolbox 伺服器與資料來源。 Google 的 入門文件 涵蓋伺服器、工具定義與支援的整合方式。首次評估時，請選擇範圍狹窄、唯讀的資料庫工具，並檢查伺服器的存取控制。SDK 儲存庫列出的基礎執行環境為 Java 17 或更新版本。
  2. 固定 Java 相依套件版本。 該 1.0 版發布公告 與 儲存庫 都列出 Maven 座標 com.google.cloud.mcp:mcp-toolbox-sdk-java:1.0.0；儲存庫也提供 Gradle 格式。一般 Java 文件仍使用 VERSION 佔位符，因此本次評估應以精確的發布成品為準。
  3. 連線至伺服器並檢查工具。 將 McpToolboxClient 指向正在執行的伺服器 /mcp URL，接著使用 loadToolset、 listTools 或 loadTool 檢視其已發布的定義，再呼叫工具。儲存庫展示了使用 Java Map 進行呼叫並取得文字結果的方式。成功的檢查應收到具名且已設定工具的回應，而不只是建立用戶端物件時沒有錯誤。
  4. 審慎選擇驗證方式。 1.0 公告說明了 CredentialsProvider 與 AuthMethods 作為用戶端憑證的方式，其中包括用於 OIDC 的 Google Application Default Credentials 路徑。公告也提到憑證可能以純文字傳輸時的 HTTP 警告。警告不能取代 HTTPS 端點或伺服器端授權。特別是在從預覽版升級時，應在伺服器與用戶端邊界檢視敏感參數的綁定值。

應檢查工具定義與結果是否符合預期授予代理程式的資料庫權限。若探索失敗，先確認伺服器 URL、可用工具名稱與驗證設定。若呼叫失敗，應比較工具要求的參數與送出的值，並檢查伺服器記錄。這些是根據文件所述元件分工提出的診斷檢查，不表示任何特定部署都能自動復原。

限制與成本

Google 的 示範交通應用程式 展示 Spring Boot 與 LangChain4j 呼叫由 AlloyDB 支援的 Toolbox 工具。10 月文章稱 Cymbal Transit 是虛構案例。它展示的是整合設計，而非客戶實際使用或可靠度測試結果。

Java SDK 儲存庫採用 Apache 2.0 授權。這並未決定資料庫、雲端部署、模型呼叫或網路流量的價格；團隊應依實際選用的服務估算費用。儲存庫將 GraalVM 原生映像支援標示為實驗性，並提醒 Java SDK 的功能支援尚未達到其他 Toolbox 用戶端的程度。在將 Google 對企業適用性的主張視為已經在正式系統中驗證之前，請依實際框架與資料來源檢查這些限制。

來源與延伸閱讀