Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# Google 說明 MCP Toolbox Java SDK 1.0 如何支援資料庫代理程式

> Google 在 10 月詳細介紹其 MCP Toolbox Java SDK 1.0，程式碼則於 9 月發布。用戶端新增傳輸與驗證介面，而版本紀錄列出一項破壞性變更，儲存庫也提醒功能支援尚未完整對等。

By BIG CHANGE Editorial

Published: 2026-10-12T18:00:12.162Z
Updated: 2026-10-12T18:00:12.162Z
Canonical: https://bigchange.ai/blog/google-mcp-toolbox-java-sdk-v1-stable-interfaces

![Conceptual charcoal illustration of an orange network cable plugged into a generic server-rack patch panel.](https://bigchange.ai/api/media/file/mcp-toolbox-java-patch-bay-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE. No MCP Toolbox product interface, database transaction or tested integration is depicted.

Google 的 MCP Toolbox for Databases Java 用戶端於 9 月 9 日達到 1.0.0 版。在 10 月 6 日的 [公告](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/)中，該公司說明了傳輸、驗證與工具參數的變更，供將 Java 應用程式連接至獨立執行 Toolbox 伺服器的團隊參考。 [版本紀錄](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) 顯示程式碼發布時間比該公告早了將近一個月。

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

## 重大變化

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

Toolbox 本身是獨立伺服器。操作人員會為其設定資料來源與工具；Java 用戶端連線至該伺服器的 URL、載入工具定義並送出呼叫。僅新增 Java 相依套件並不會設定資料庫、授予權限或部署伺服器。 [官方 Java 文件](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) 說明了用戶端與伺服器的角色，而 [SDK 儲存庫](https://github.com/googleapis/mcp-toolbox-sdk-java) 要求在設定用戶端前先啟動伺服器。

## Java 團隊可以評估的事項

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

1. **準備獨立的 Toolbox 伺服器與資料來源。** Google 的 [入門文件](https://mcp-toolbox.dev/documentation/introduction/) 涵蓋伺服器、工具定義與支援的整合方式。首次評估時，請選擇範圍狹窄、唯讀的資料庫工具，並檢查伺服器的存取控制。SDK 儲存庫列出的基礎執行環境為 Java 17 或更新版本。
2. **固定 Java 相依套件版本。** 該 [1.0 版發布公告](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) 與 [儲存庫](https://github.com/googleapis/mcp-toolbox-sdk-java) 都列出 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 的 [示範交通應用程式](https://github.com/googleapis/mcp-toolbox-sdk-java/tree/main/demo-applications/cymbal-transit) 展示 Spring Boot 與 LangChain4j 呼叫由 AlloyDB 支援的 Toolbox 工具。10 月文章稱 Cymbal Transit 是虛構案例。它展示的是整合設計，而非客戶實際使用或可靠度測試結果。

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

## 來源與延伸閱讀

- [Google Cloud 公告，2026 年 10 月 6 日](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/)：Google 對 v1.0 功能及虛構交通案例的說明。其適合正式環境的措辭是供應商主張。
- [Java SDK v1.0.0 發布，2026 年 9 月 9 日](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0)：發布日期、功能與列出的破壞性變更。
- [Java SDK 儲存庫](https://github.com/googleapis/mcp-toolbox-sdk-java)：相依套件座標、Java 要求、用戶端呼叫、授權與目前的功能對等警告。閱讀日期：2026 年 10 月 12 日。
- [官方 Java SDK 文件](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/)：伺服器前置條件與安裝參考。頁面最後修改於 2026 年 9 月 25 日；其版本佔位符不如 1.0 發布紀錄精確。

## Sources

- [Google Cloud Blog：宣布 MCP Toolbox Java SDK v1.0](https://cloud.google.com/blog/topics/developers-practitioners/announcing-mcp-toolbox-java-sdk-v10-agentic-data-access-for-the-enterprise/) — 後續公告並說明 9 月 9 日的發布。對正式環境適用性的說法是 Google 的主張，未經獨立驗證。
- [MCP Toolbox Java SDK v1.0.0 發布](https://github.com/googleapis/mcp-toolbox-sdk-java/releases/tag/v1.0.0) — 具權威性的程式碼發布日期與功能資訊，包括所列破壞性變更。
- [Google APIs：MCP Toolbox Java SDK 原始碼儲存庫](https://github.com/googleapis/mcp-toolbox-sdk-java) — 官方實作來源；使用程式碼範例前，請依 v1.0.0 核對目前的發布標籤與 API。
- [MCP Toolbox Java SDK 官方文件](https://mcp-toolbox.dev/documentation/connect-to/toolbox-sdks/java-sdk/) — 一般官方設定參考仍含 VERSION 佔位符；固定的 1.0 發布版本與儲存庫更精確。