Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand All @@ -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

Expand All @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/question.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
8 changes: 4 additions & 4 deletions .github/renovate.json5
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand All @@ -48,9 +48,9 @@
'_TOOLBOX_VERSION: [\'|"]?(?<currentValue>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',
},
],
}
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -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 ☕

Expand All @@ -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.

Expand Down Expand Up @@ -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

Expand Down Expand Up @@ -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

Expand Down
23 changes: 10 additions & 13 deletions demo-applications/cymbal-transit/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
Comment thread
anubhav756 marked this conversation as resolved.
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:
Expand Down
6 changes: 3 additions & 3 deletions example/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -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/cloud-run/

> [!NOTE]
> At this point you must be having a working MCP Toolbox server accessible.
Expand Down
2 changes: 1 addition & 1 deletion integration.cloudbuild.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Original file line number Diff line number Diff line change
Expand Up @@ -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);
}
Expand Down
Loading