Skip to content

Commit f848063

Browse files
Merge branch 'main' into test/complex-params-e2e-tests
2 parents da3c364 + 746a7f5 commit f848063

65 files changed

Lines changed: 2850 additions & 2142 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.github/sync-repo-settings.yaml

Lines changed: 0 additions & 55 deletions
This file was deleted.

.github/workflows/lint-toolbox-adk.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,12 +67,12 @@ jobs:
6767
with:
6868
python-version: "3.13"
6969

70+
- name: Install test requirements
71+
run: pip install -e .[test]
72+
7073
- name: Install library requirements
7174
run: pip install -r requirements.txt
7275

73-
- name: Install test requirements
74-
run: pip install .[test]
75-
7676
- name: Run linters
7777
run: |
7878
black --check .

.github/workflows/lint-toolbox-core.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,12 +67,12 @@ jobs:
6767
with:
6868
python-version: "3.13"
6969

70+
- name: Install test requirements
71+
run: pip install -e .[test]
72+
7073
- name: Install library requirements
7174
run: pip install -r requirements.txt
7275

73-
- name: Install test requirements
74-
run: pip install .[test]
75-
7676
- name: Run linters
7777
run: |
7878
black --check .

.github/workflows/lint-toolbox-langchain.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,12 +67,12 @@ jobs:
6767
with:
6868
python-version: "3.13"
6969

70+
- name: Install test requirements
71+
run: pip install -e .[test]
72+
7073
- name: Install library requirements
7174
run: pip install -r requirements.txt
7275

73-
- name: Install test requirements
74-
run: pip install .[test]
75-
7676
- name: Run linters
7777
run: |
7878
black --check .

.github/workflows/lint-toolbox-llamaindex.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,12 +67,12 @@ jobs:
6767
with:
6868
python-version: "3.13"
6969

70+
- name: Install test requirements
71+
run: pip install -e .[test]
72+
7073
- name: Install library requirements
7174
run: pip install -r requirements.txt
7275

73-
- name: Install test requirements
74-
run: pip install .[test]
75-
7676
- name: Run linters
7777
run: |
7878
black --check .

.release-please-manifest.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
2-
"packages/toolbox-langchain": "0.5.10",
3-
"packages/toolbox-core": "0.5.10",
4-
"packages/toolbox-llamaindex": "0.5.10",
5-
"packages/toolbox-adk": "0.6.1"
2+
"packages/toolbox-langchain": "1.0.0",
3+
"packages/toolbox-core": "1.0.0",
4+
"packages/toolbox-llamaindex": "1.0.0",
5+
"packages/toolbox-adk": "1.0.0"
66
}

README.md

Lines changed: 15 additions & 75 deletions
Original file line numberDiff line numberDiff line change
@@ -14,83 +14,33 @@ applications. These SDKs allow you to load tools defined in Toolbox and use them
1414
as standard Python functions or objects within popular orchestration frameworks
1515
or your custom code.
1616

17-
This simplifies the process of incorporating external functionalities (like
18-
Databases or APIs) managed by Toolbox into your GenAI applications.
17+
For comprehensive guides and advanced configuration, visit the [Main Documentation Site](https://googleapis.github.io/genai-toolbox/).
18+
1919

2020
<!-- TOC -->
21-
- [Overview](#overview)
22-
- [Which Package Should I Use?](#which-package-should-i-use)
2321
- [Available Packages](#available-packages)
24-
- [Getting Started](#getting-started)
22+
- [Quickstart](#quickstart)
2523
- [Contributing](#contributing)
2624
- [License](#license)
2725
- [Support](#support)
2826

2927
<!-- /TOC -->
3028

31-
## Overview
32-
33-
The MCP Toolbox service provides a centralized way to manage and expose tools
34-
(like API connectors, database query tools, etc.) for use by GenAI applications.
35-
36-
These Python SDKs act as clients for that service. They handle the communication needed to:
37-
38-
* Fetch tool definitions from your running Toolbox instance.
39-
* Provide convenient Python objects or functions representing those tools.
40-
* Invoke the tools (calling the underlying APIs/services configured in Toolbox).
41-
* Handle authentication and parameter binding as needed.
42-
43-
By using these SDKs, you can easily leverage your Toolbox-managed tools directly
44-
within your Python applications or AI orchestration frameworks.
45-
46-
## Which Package Should I Use?
47-
48-
Choosing the right package depends on how you are building your application:
49-
50-
* [`toolbox-adk`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-adk):
51-
Use this package if you are building your application using Google ADK (Agent Development Kit).
52-
It provides tools that are directly compatible with the
53-
Google ADK ecosystem (`BaseTool` / `BaseToolset` interface) handling authentication propagation, header management, and tool wrapping automatically.
54-
* [`toolbox-core`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-core):
55-
Use this package if you are not using LangChain/LangGraph or any other
56-
orchestration framework, or if you need a framework-agnostic way to interact
57-
with Toolbox tools (e.g., for custom orchestration logic or direct use in
58-
Python scripts).
59-
* [`toolbox-langchain`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-langchain):
60-
Use this package if you are building your application using the LangChain or
61-
LangGraph frameworks. It provides tools that are directly compatible with the
62-
LangChain ecosystem (`BaseTool` interface), simplifying integration.
63-
* [`toolbox-llamaindex`](https://github.com/googleapis/mcp-toolbox-sdk-python/tree/main/packages/toolbox-llamaindex):
64-
Use this package if you are building your application using the LlamaIndex framework.
65-
It provides tools that are directly compatible with the
66-
LlamaIndex ecosystem (`BaseTool` interface), simplifying integration.
67-
6829
## Available Packages
6930

70-
This repository hosts the following Python packages. See the package-specific
71-
README for detailed installation and usage instructions:
31+
This repository hosts the following Python packages. See the package-specific READMEs or the docsite for detailed usage:
7232

73-
| Package | Target Use Case | Integration | Path | Details (README) | PyPI Status |
74-
| :------ | :---------- | :---------- | :---------------------- | :---------- | :---------
75-
| `toolbox-adk` | Google ADK applications | Google ADK | `packages/toolbox-adk/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-adk/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-adk.svg) |
76-
| `toolbox-core` | Framework-agnostic / Custom applications | Use directly / Custom | `packages/toolbox-core/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-core/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-core.svg) |
77-
| `toolbox-langchain` | LangChain / LangGraph applications | LangChain / LangGraph | `packages/toolbox-langchain/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-langchain/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-langchain.svg) |
78-
| `toolbox-llamaindex` | LlamaIndex applications | LlamaIndex | `packages/toolbox-llamaindex/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-python/blob/main/packages/toolbox-llamaindex/README.md) | ![pypi version](https://img.shields.io/pypi/v/toolbox-llamaindex.svg) |
33+
| Package | Target Use Case | Path | Documentation |
34+
| :------ | :---------- | :--- | :---------- |
35+
| `toolbox-core` | Framework-agnostic / Custom apps | `packages/toolbox-core/` | [Python Core Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/core/) |
36+
| `toolbox-adk` | Google ADK Integration | `packages/toolbox-adk/` | [ADK Package Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/adk/) |
37+
| `toolbox-langchain` | LangChain / LangGraph Integration | `packages/toolbox-langchain/` | [LangChain Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/langchain/) |
38+
| `toolbox-llamaindex` | LlamaIndex Integration | `packages/toolbox-llamaindex/` | [LlamaIndex Guide](https://googleapis.github.io/genai-toolbox/sdks/python-sdk/llamaindex/) |
7939

40+
## Quickstart
8041

81-
## Getting Started
82-
83-
To get started using Toolbox tools with an application, follow these general steps:
84-
85-
1. **Set up and Run the Toolbox Service:**
86-
87-
Before using the SDKs, you need the main MCP Toolbox service running. Follow
88-
the instructions here: [**Toolbox Getting Started
89-
Guide**](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started)
90-
42+
1. **Set up the Toolbox Service**: Ensure you have a running MCP Toolbox server. Follow the [MCP Toolbox Server Getting Started Guide](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started).
9143
2. **Install the Appropriate SDK:**
92-
93-
Choose the package based on your needs (see "[Which Package Should I Use?](#which-package-should-i-use)" above) and install it:
9444

9545
```bash
9646
# For the Google ADK
@@ -105,23 +55,13 @@ To get started using Toolbox tools with an application, follow these general ste
10555

10656
# For LangChain/LangGraph integration
10757
pip install toolbox-langchain
58+
59+
# OR
10860

10961
# For the LlamaIndex integration
11062
pip install toolbox-llamaindex
111-
```
112-
113-
3. **Use the SDK:**
114-
115-
Consult the README for your chosen package (linked in the "[Available
116-
Packages](#available-packages)" section above) for detailed instructions on
117-
how to connect the client, load tool definitions, invoke tools, configure
118-
authentication/binding, and integrate them into your application or
119-
framework.
12063

121-
> [!TIP]
122-
> For a complete, end-to-end example including setting up the service and using
123-
> an SDK, see the full tutorial: [**Toolbox Quickstart
124-
> Tutorial**](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart)
64+
3. **Explore Tutorials**: Check out the [Python Quickstart Tutorial](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart/) for a full walkthrough.
12565

12666
## Contributing
12767

packages/toolbox-adk/CHANGELOG.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,37 @@
11
# Changelog
22

3+
## [1.0.0](https://github.com/googleapis/mcp-toolbox-sdk-python/compare/toolbox-adk-v0.7.0...toolbox-adk-v1.0.0) (2026-03-25)
4+
5+
6+
### Features
7+
8+
* **adk:** Enable support for ADK 2.0 ([#584](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/584)) ([7effeb5](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/7effeb518e88329b32fa32bbacc08bf9e6de5de4))
9+
* **adk:** Support `ToolContext` for `auth_token_getters` in `toolbox-adk` ([#579](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/579)) ([05e5f2c](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/05e5f2cba0a123c14594508eeee6bd228274b138))
10+
* **core:** add observability with OpenTelemetry ([#583](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/583)) ([d479385](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/d479385cccf31a7cb1dffcc4634ddb6fe7ef932a))
11+
12+
13+
### Bug Fixes
14+
15+
* **adk:** Preserve complex schema types (arrays/objects) in `FunctionDeclaration` mapping ([#594](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/594)) ([c91e7d5](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/c91e7d50383c10f4c4e9ee682c6da3912b574612))
16+
* **adk:** remove id_token monkey patch following upstream ADK fix ([#602](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/602)) ([d9cd9aa](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/d9cd9aa5a0fd80349be78e9b6a5242af469e463a))
17+
18+
19+
### Documentation
20+
21+
* Documentation migrated to MCP Toolbox official docsite. ([#581](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/581)) ([da12899](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/da1289944d8d401c0d2b958ae47da42da729848e))
22+
23+
## [0.7.0](https://github.com/googleapis/mcp-toolbox-sdk-python/compare/toolbox-adk-v0.6.1...toolbox-adk-v0.7.0) (2026-03-05)
24+
25+
26+
### ⚠ BREAKING CHANGES
27+
28+
* remove legacy Native Toolbox HTTP transport ([#566](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/566))
29+
30+
### Features
31+
32+
* remove legacy Native Toolbox HTTP transport ([#566](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/566)) ([6a55554](https://github.com/googleapis/mcp-toolbox-sdk-python/commit/6a55554a1c53030fd25b6a6de44ea9603b5201a3))
33+
34+
335
## [0.6.1](https://github.com/googleapis/mcp-toolbox-sdk-python/compare/toolbox-adk-v0.6.0...toolbox-adk-v0.6.1) (2026-02-27)
436

537

0 commit comments

Comments
 (0)