From 19ead14b473477cbccf96eea5eab33c82b5a3968 Mon Sep 17 00:00:00 2001 From: Anubhav Dhawan Date: Thu, 16 Apr 2026 19:23:08 +0530 Subject: [PATCH 1/4] doc: deprecate legacy genai-toolbox strings in java sdk ecosystem --- .github/ISSUE_TEMPLATE/bug_report.yml | 4 ++-- .github/ISSUE_TEMPLATE/question.yml | 2 +- .github/renovate.json5 | 8 +++---- README.md | 12 +++++----- demo-applications/cymbal-transit/README.md | 23 ++++++++----------- example/README.md | 6 ++--- .../google/cloud/mcp/e2e/ToolboxE2ESetup.java | 2 +- 7 files changed, 27 insertions(+), 30 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index 85c2b05..a004c72 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -30,7 +30,7 @@ body: description: | Please run through the following list and make sure you've tried the usual "quick fixes": - Search the [current open issues](https://github.com/googleapis/mcp-toolbox-sdk-java/issues) - - Update to the [latest version of MCP Toolbox](https://github.com/googleapis/genai-toolbox/releases) + - Update to the [latest version of MCP Toolbox](https://github.com/googleapis/mcp-toolbox/releases) - Update to the [latest version of the SDK](https://github.com/googleapis/mcp-toolbox-sdk-java/blob/main/CHANGELOG.md). options: - label: "I've searched the current open issues" @@ -58,7 +58,7 @@ body: value: | 1. OS type and version: (output of `uname -a`) 2. How are you running MCP Toolbox: - - As a downloaded binary (e.g. from `curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox`) + - As a downloaded binary (e.g. from `curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/linux/amd64/toolbox`) - As a container (e.g. from `us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION`) - Compiled from source (include the command used to build) 3. Java version: diff --git a/.github/ISSUE_TEMPLATE/question.yml b/.github/ISSUE_TEMPLATE/question.yml index 87ba9f3..b2e8686 100644 --- a/.github/ISSUE_TEMPLATE/question.yml +++ b/.github/ISSUE_TEMPLATE/question.yml @@ -30,7 +30,7 @@ body: description: | Please run through the following list and make sure you've tried the usual "quick fixes": options: - - label: "Search the [current open issues](https://github.com/googleapis/genai-toolbox/issues)" + - label: "Search the [current open issues](https://github.com/googleapis/mcp-toolbox-sdk-java/issues)" required: true - type: textarea diff --git a/.github/renovate.json5 b/.github/renovate.json5 index fb89a96..5dccb68 100644 --- a/.github/renovate.json5 +++ b/.github/renovate.json5 @@ -24,9 +24,9 @@ pinDigests: true, }, { - description: 'Auto-update genai-toolbox server version', + description: 'Auto-update mcp-toolbox server version', matchPackageNames: [ - 'googleapis/genai-toolbox', + 'googleapis/mcp-toolbox', ], matchManagers: [ 'custom.regex', @@ -48,9 +48,9 @@ '_TOOLBOX_VERSION: [\'|"]?(?v?\\d+\\.\\d+\\.\\d+)[\'|"]?', ], datasourceTemplate: 'github-releases', - depNameTemplate: 'googleapis/genai-toolbox', + depNameTemplate: 'googleapis/mcp-toolbox', versioningTemplate: 'semver', - packageNameTemplate: 'googleapis/genai-toolbox', + packageNameTemplate: 'googleapis/mcp-toolbox', }, ], } diff --git a/README.md b/README.md index bbd3ac7..5ab228d 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,5 @@ ![MCP Toolbox -Logo](https://raw.githubusercontent.com/googleapis/genai-toolbox/main/logo.png) +Logo](https://raw.githubusercontent.com/googleapis/mcp-toolbox/main/logo.png) # MCP Toolbox SDK for Java ☕ @@ -13,7 +13,7 @@ The official Java Client SDK for the MCP Toolbox. This repository contains SDK designed to seamlessly integrate the functionalities of the [MCP -Toolbox](https://github.com/googleapis/genai-toolbox) into your Agentic +Toolbox](https://github.com/googleapis/mcp-toolbox) into your Agentic applications. This allows you to load tools defined in Toolbox and use them as standard Java applications (Spring Boot, Quarkus, Jakarta EE) or your custom code. It empowers your AI Agents to "use tools"—querying databases, calling APIs, or managing files—without you writing the boilerplate integration code. @@ -82,8 +82,8 @@ This SDK is designed to be versatile, supporting both modern cloud infrastructur ## Getting Started -First make sure Toolbox Server is set up and is running (either locally or deployed on Cloud Run). Follow the instructions here: [**Toolbox Getting Started - Guide**](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started) +First make sure MCP Toolbox Server is set up and is running (either locally or deployed on Cloud Run). Follow the instructions here: [**MCP Toolbox Getting Started + Guide**](https://mcp-toolbox.dev/documentation/introduction/#getting-started) ## Installation @@ -299,11 +299,11 @@ Authentication is configured per-tool within the Toolbox service itself. If a to ### Supported Authentication Mechanisms -The Toolbox service enables secure tool usage through Authenticated Parameters. For detailed information on how these mechanisms work within the Toolbox service and how to configure them, please refer to [Toolbox Service Documentation \- Authenticated Parameters](https://googleapis.github.io/genai-toolbox/resources/tools/#authenticated-parameters) +The Toolbox service enables secure tool usage through Authenticated Parameters. For detailed information on how these mechanisms work within the Toolbox service and how to configure them, please refer to [MCP Toolbox Authentication](https://mcp-toolbox.dev/documentation/configuration/authentication/) ### Step 1: Configure Tools in Toolbox Service -First, ensure the target tool(s) are configured correctly in the Toolbox service to require authentication. Refer to the [Toolbox Service Documentation \- Authenticated Parameters](https://googleapis.github.io/genai-toolbox/resources/tools/#authenticated-parameters) for instructions. +First, ensure the target tool(s) are configured correctly in the Toolbox service to require authentication. Refer to the [Authenticated Parameters](https://mcp-toolbox.dev/documentation/configuration/tools/#authenticated-parameters) for instructions. ### Step 2: Configure SDK Client diff --git a/demo-applications/cymbal-transit/README.md b/demo-applications/cymbal-transit/README.md index 243c4fd..11abe35 100644 --- a/demo-applications/cymbal-transit/README.md +++ b/demo-applications/cymbal-transit/README.md @@ -3,16 +3,13 @@ ### Cymbal Bus Agent ##### 1. AlloyDB database and MCP Toolbox for AlloyDB for tools integration. -##### 2. Cloud Run for Toolbox Deployment and Application (agent deployment). +##### 2. Cloud Run for MCP Toolbox Deployment and Application (agent deployment). ##### 3. LangChain4J library for the agent and LLM framework in a Spring Boot Application with Java 17. #### AlloyDB Setup ##### Install AlloyDB Cluster and Instance -Once click setup here: -``` url -https://codelabs.developers.google.com/quick-alloydb-setup -``` +Follow the [AlloyDB 1-Click Setup](https://codelabs.developers.google.com/quick-alloydb-setup) instructions. ##### Extensions ``` sql @@ -89,20 +86,20 @@ Check repo for file. Replace the placeholders represented by "*****" with your values in Tools.yaml file. You can parameterize these values as environment variables. -#### Install Toolbox +#### Install MCP Toolbox ``` bash # see releases page for other versions -export VERSION=0.27.0 -curl -L -o toolbox https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox +export VERSION=1.1.0 +curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/linux/amd64/toolbox chmod +x toolbox ``` -#### Deploy Toolbox to Cloud Run -Follow all the steps in the documentation. Including the authentication part. This is critical. -``` url -https://googleapis.github.io/genai-toolbox/how-to/deploy_toolbox/ -``` +#### Deploy MCP Toolbox +Follow all the steps in the [Deployment Documentation](https://mcp-toolbox.dev/documentation/deploy-to/). + +> [!IMPORTANT] +> Setting up client authentication is critical for secure integrations. #### Clone this repo Replace your environment variables locally in the controller class and run it locally. To run locally: diff --git a/example/README.md b/example/README.md index 3410364..f135549 100644 --- a/example/README.md +++ b/example/README.md @@ -11,11 +11,11 @@ These sample Java files allow you to test the features supported in the Java ver 2. To start with tools, go ahead and create the MCP Toolbox Server for the sameple use case we are looking at. 3. To set up & install **MCP Toolbox Server**, install the latest version from here: - https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#installing-the-server + https://mcp-toolbox.dev/documentation/introduction/#install-toolbox 4. Next, create **tools.yaml**, you can find the one we are using in our example in this repo. -5. Replace the placeholder variables in `tools.yaml` with values from your instance / environment +5. Replace the placeholder variables in `tools.yaml` with values from your instance / environment. > [!TIP] > Do not hardcode for production applications. @@ -33,7 +33,7 @@ These sample Java files allow you to test the features supported in the Java ver 7. You can then deploy this in Cloud Run to test the application or use the local instance running, while you try the example Java applications. In any case remember to change the `YOUR_TOOLBOX_SERVICE_ENDPOINT` placeholder in the respective files. - If you decide to deploy your toolbox endpoint in cloud run, here's how you can do it: https://googleapis.github.io/genai-toolbox/how-to/deploy_toolbox + If you decide to deploy your toolbox endpoint in cloud run, here's how you can do it: https://mcp-toolbox.dev/documentation/deploy-to/ > [!NOTE] > At this point you must be having a working MCP Toolbox server accessible. diff --git a/src/test/java/com/google/cloud/mcp/e2e/ToolboxE2ESetup.java b/src/test/java/com/google/cloud/mcp/e2e/ToolboxE2ESetup.java index a5044ab..06ab3fe 100644 --- a/src/test/java/com/google/cloud/mcp/e2e/ToolboxE2ESetup.java +++ b/src/test/java/com/google/cloud/mcp/e2e/ToolboxE2ESetup.java @@ -161,7 +161,7 @@ private void downloadToolboxBinary(String version) { logger.info("Downloading toolbox binary from: " + blobName); Storage storage = StorageOptions.getDefaultInstance().getService(); - Blob blob = storage.get("genai-toolbox", blobName); + Blob blob = storage.get("mcp-toolbox-for-databases", blobName); if (blob == null) { throw new RuntimeException("Toolbox binary not found in GCS: " + blobName); } From 9d8b1e0eafb2819de071142eb2ea6d1adc2e5de6 Mon Sep 17 00:00:00 2001 From: Anubhav Dhawan Date: Thu, 16 Apr 2026 21:01:27 +0530 Subject: [PATCH 2/4] fix: Fix CI version --- integration.cloudbuild.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/integration.cloudbuild.yaml b/integration.cloudbuild.yaml index e07fe8c..200332a 100644 --- a/integration.cloudbuild.yaml +++ b/integration.cloudbuild.yaml @@ -26,7 +26,7 @@ steps: - TOOLBOX_VERSION=${_TOOLBOX_VERSION} - TOOLBOX_MANIFEST_VERSION=${_TOOLBOX_MANIFEST_VERSION} substitutions: - _TOOLBOX_VERSION: '0.26.0' + _TOOLBOX_VERSION: '1.1.0' _TOOLBOX_MANIFEST_VERSION: '34' options: logging: CLOUD_LOGGING_ONLY From 0174e4c398534ab8a3901ccec6aab7c8b4ebf602 Mon Sep 17 00:00:00 2001 From: Anubhav Dhawan Date: Fri, 17 Apr 2026 00:10:44 +0530 Subject: [PATCH 3/4] docs: Update toolbox version in template sample --- .github/ISSUE_TEMPLATE/bug_report.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml index a004c72..8910228 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yml +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -44,9 +44,9 @@ body: label: MCP Toolbox version description: | What version of MCP Toolbox are you using (`toolbox --version`)? e.g. - - toolbox version 0.3.0 - - us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:0.3.0 - placeholder: e.g. toolbox version 0.3.0 + - toolbox version 1.1.0 + - us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:1.1.0 + placeholder: e.g. toolbox version 1.1.0 validations: required: true From e86b5433df5adc3f057db0cc2b0fa8a93fb35927 Mon Sep 17 00:00:00 2001 From: Anubhav Dhawan Date: Fri, 17 Apr 2026 00:12:24 +0530 Subject: [PATCH 4/4] docs: Update cloud run guide link --- example/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/example/README.md b/example/README.md index f135549..672a4d5 100644 --- a/example/README.md +++ b/example/README.md @@ -33,7 +33,7 @@ These sample Java files allow you to test the features supported in the Java ver 7. You can then deploy this in Cloud Run to test the application or use the local instance running, while you try the example Java applications. In any case remember to change the `YOUR_TOOLBOX_SERVICE_ENDPOINT` placeholder in the respective files. - If you decide to deploy your toolbox endpoint in cloud run, here's how you can do it: https://mcp-toolbox.dev/documentation/deploy-to/ + If you decide to deploy your toolbox endpoint in cloud run, here's how you can do it: https://mcp-toolbox.dev/documentation/deploy-to/cloud-run/ > [!NOTE] > At this point you must be having a working MCP Toolbox server accessible.