Averi Kitsch
032b333961
docs: Add prebuilt tools documentation ( #602 )
...
Co-authored-by: trehanshakuntG <trehanshakunt@google.com >
Co-authored-by: Prerna Kakkar <prernakakkar@google.com >
Co-authored-by: prernakakkar-google <158031829+prernakakkar-google@users.noreply.github.com >
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
Co-authored-by: Yuan Teoh <yuanteoh@google.com >
2025-05-28 22:38:16 +00:00
Yuan
25afd63496
chore: fix release please version update ( #622 )
2025-05-28 15:33:50 -07:00
release-please[bot]
3180830403
chore(main): release 0.6.0 ( #545 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.6.0](https://github.com/googleapis/genai-toolbox/compare/v0.5.0...v0.6.0 )
(2025-05-28)
### Features
* Add Execute sql tool for SQL Server(MSSQL)
([#585 ](https://github.com/googleapis/genai-toolbox/issues/585 ))
([6083a226083a224aa#577 ](https://github.com/googleapis/genai-toolbox/issues/577 ))
([85900618590061ae40fd88b50fd88b574b#576 ](https://github.com/googleapis/genai-toolbox/issues/576 ))
([d65747ad65747a2dc#563 ](https://github.com/googleapis/genai-toolbox/issues/563 ))
([65127046512704e77#604 ](https://github.com/googleapis/genai-toolbox/issues/604 ))
([a29c800a29c80012e#607 ](https://github.com/googleapis/genai-toolbox/issues/607 ))
([1702ce11702ce1e00#586 ](https://github.com/googleapis/genai-toolbox/issues/586 ))
([eb52b66eb52b66d82#561 ](https://github.com/googleapis/genai-toolbox/issues/561 ))
([b58bf76b58bf76dda#544 ](https://github.com/googleapis/genai-toolbox/issues/544 ))
([e747b6ee747b6e289#571 ](https://github.com/googleapis/genai-toolbox/issues/571 ))
([04dcf4704dcf47912#564 ](https://github.com/googleapis/genai-toolbox/issues/564 )
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2025-05-28 15:08:44 -07:00
Huan Chen
0fd88b574b
feat: add new bigquery tools. ( #619 )
...
Added five new tools and corresponding documents:
1. bigquery-execute-sql
2. bigquery-list-dataset-ids
3. bigquery-list-table-ids
4. bigquery-get-dataset-info
5. bigquery-get-table-info
---------
Co-authored-by: duwenxin <duwenxin@google.com >
Co-authored-by: Wenxin Du <117315983+duwenxin99@users.noreply.github.com >
2025-05-28 14:38:08 -07:00
Yuan
1702ce1e00
feat: support MCP stdio transport protocol ( #607 )
...
Support MCP
[stdio](https://modelcontextprotocol.io/specification/2024-11-05/basic/transports#stdio )
transport protocol!
To run stdio with Toolbox, user have to use the `--stdio` flag.
Example of running MCP Toolbox with MCP Inspector via stdio transport
protocol: `npx @modelcontextprotocol/inspector ./toolbox --stdio`.
---------
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
Co-authored-by: Averi Kitsch <akitsch@google.com >
2025-05-28 10:10:34 -07:00
Yuan
1bf6003eae
docs: add note to tools ( #608 )
...
Co-authored-by: Averi Kitsch <akitsch@google.com >
2025-05-28 15:38:18 +00:00
Anubhav Dhawan
22edbea579
docs: Update docs to guide with proper lifecycle management ( #606 )
...
Fixes
[#208 ](https://github.com/googleapis/mcp-toolbox-sdk-python/issues/208 )
2025-05-26 20:12:53 +05:30
Huan Chen
8df757b280
docs: add note for bigquery parameter replacement introduction. ( #589 )
...
For issue https://github.com/googleapis/genai-toolbox/issues/566
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
2025-05-23 17:54:05 +00:00
prernakakkar-google
6083a224aa
Feat: Add Execute sql tool for SQL Server(MSSQL) ( #585 )
...
This tool can be used across mssql(SQL Server) sources.
`mssql-execute-sql` config is as below:
```
tools:
mssql_execute_sql_tool:
kind: "mssql-execute-sql"
source: my-mssql-source
description: Use this tool to execute sql.
```
The `mssql-execute-sql` tool takes one parameter. Example request as
follow:
```
curl -X POST -H "Content-Type: application/json" -d '{"sql": "SELECT 1"}' http://127.0.0.1:5000/api/tool/mssql_execute_sql_tool/invoke
```
Reference for bug: b/416163913
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
Co-authored-by: Mend Renovate <bot@renovateapp.com >
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
Co-authored-by: Anubhav Dhawan <anubhavdhawan@google.com >
Co-authored-by: Huan Chen <142538604+Genesis929@users.noreply.github.com >
2025-05-22 00:10:55 +05:30
Jack Wotherspoon
0c07e15c2c
docs: update ADK samples to use toolbox-core ( #584 )
...
`ToolboxTool` has been removed from `google-adk` package in
11ca528090http://127.0.0.1:5000 ")
toolbox_tools = toolbox_client.load_toolset("my-toolset")
root_agent = Agent(
model="gemini-2.0-flash",
name="root_agent",
instruction=agent_instruction,
# Add Toolbox tools to ADK agent
tools=toolbox_tools,
)
```
2025-05-20 17:44:50 +00:00
Twisha Bansal
0e4564f383
docs: change docs to add authenticated Toolbox Cloud Run access ( #575 )
2025-05-20 21:26:38 +05:30
trehanshakuntG
d65747a2dc
feat: add spanner-execute-sql tool ( #576 )
...
This tool can be used across spanner sources.
`spanner-execute-sql` config is as below:
```
tools:
spanner_execute_sql_tool:
kind: "spanner-execute-sql"
source: my-spanner-source
description: Use this tool to execute sql.
```
The `spanner-execute-sql` tool takes one parameter. Example request as
follow:
```
curl -X POST -H "Content-Type: application/json" -d '{"sql": "SELECT 1"}' http://127.0.0.1:5000/api/tool/spanner_execute_sql_tool/invoke
```
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
2025-05-19 14:48:11 -07:00
trehanshakuntG
8590061ae4
feat: add mysql-execute-sql tool ( #577 )
...
This tool can be used across mysql sources.
`mysql-execute-sql` config is as below:
```
tools:
mysql_execute_sql_tool:
kind: "mysql-execute-sql"
source: my-mysql-source
description: Use this tool to execute sql.
```
The `mysql-execute-sql` tool takes one parameter. Example request as
follow:
```
curl -X POST -H "Content-Type: application/json" -d '{"sql": "SELECT 1"}' http://127.0.0.1:5000/api/tool/mysql_execute_sql_tool/invoke
```
2025-05-20 02:17:39 +05:30
trehanshakuntG
6512704e77
feat: Add support for read-only in Spanner tool ( #563 )
...
Allowing user to add `readOnly` field in spanner tools.
The existing tool doesn't work for reading schema tables since schema
tables can only be accessed through read-only transaction.
This PR also resolve #435 for Spanner tool.
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
2025-05-16 12:08:05 +05:30
Averi Kitsch
ca4491b0a9
docs: separate MCP docs ( #569 )
...
Create a doc page per database for MCP Dev Assist workflows
2025-05-15 15:40:19 -07:00
An Nguyen
2068f26302
chore: fix bigtable doc typo ( #570 )
...
Fix bigtable doc typo
2025-05-15 21:44:04 +00:00
AlexTalreja
e8e0125eaa
docs: fix typo and import in local quickstart ( #565 )
2025-05-14 16:58:37 -07:00
Jack Wotherspoon
352b3ed91c
chore: update typo ( #555 )
...
Windsurf was formerly https://codeium.com/
updating typo `codium` --> `codeium`
2025-05-12 13:35:11 -04:00
Averi Kitsch
df31fa6680
docs: Add Dev Assist docs for AlloyDB ( #546 )
...
Co-authored-by: duwenxin <duwenxin@google.com >
2025-05-09 16:01:49 -04:00
Kurtis Van Gent
b2ff195831
chore: update diagram for couchbase ( #547 )
...
Update diagram to include Couchbase.
2025-05-08 15:07:24 -06:00
Jack Wotherspoon
00e3a87258
docs: update typo in export_telemetry.md ( #549 )
...
Changing "Connector" --> "Collector".
2025-05-08 11:48:53 -04:00
Twisha Bansal
8834a36445
chore: auto update toolbox version in colab quickstarts ( #534 )
2025-05-07 10:50:49 +05:30
release-please[bot]
9a5d76e2dc
chore(main): release 0.5.0 ( #484 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.5.0](https://github.com/googleapis/genai-toolbox/compare/v0.4.0...v0.5.0 )
(2025-05-06)
### Features
* Add Couchbase as Source and Tool
([#307 ](https://github.com/googleapis/genai-toolbox/issues/307 ))
([d7390b0d7390b06b7#490 ](https://github.com/googleapis/genai-toolbox/issues/490 ))
([11ea7bc11ea7bc584#500 ](https://github.com/googleapis/genai-toolbox/issues/500 ))
([ad040cfad040cfb8b#481 ](https://github.com/googleapis/genai-toolbox/issues/481 ))
([1e1348f1e1348f5f0#505 ](https://github.com/googleapis/genai-toolbox/issues/505 ))
([50ec7f450ec7f4a06https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
Co-authored-by: Yuan Teoh <yuanteoh@google.com >
2025-05-06 16:32:01 -06:00
Yuan
a087280fe2
docs: fix indentation for release please ( #540 )
2025-05-06 16:08:02 -06:00
Averi Kitsch
31a1fe971a
docs: add dev assist tools using MCP documentation ( #510 )
...
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
2025-05-06 13:58:17 -07:00
Twisha Bansal
1d096de82f
docs: use env-based project in LlamaIndex Quickstart ( #531 )
...
The `GoogleGenAI` llm directly takes in the `Project ID` [set
up](https://googleapis.github.io/genai-toolbox/samples/bigquery/local_quickstart/#before-you-begin )
in the quickstart.
Partially fixes https://github.com/googleapis/genai-toolbox/issues/518
2025-05-06 22:09:57 +05:30
Jack Wotherspoon
652dc5c2dd
docs: update colab badge link ( #536 )
...
The "Open in Colab" badge on the getting started quickstart links to the
GitHub file and not the colab.
Updating it to properly point at
https://colab.research.google.com/github/googleapis/genai-toolbox/blob/main/docs/en/getting-started/colab_quickstart.ipynb
2025-05-06 19:56:54 +05:30
Anubhav Dhawan
1dce40fc26
docs: Bump Toolbox version in Colab Quickstart + fix typo ( #533 )
2025-05-06 16:51:52 +05:30
Anubhav Dhawan
717f43420a
docs: Address connection issues in local quickstart with clearer guidance ( #520 )
...
Fix for #517
This PR improves the Local Quickstart guide by adding troubleshooting
advice for common PostgreSQL connection issues in [step
1](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart/#step-1-set-up-your-database ).
This reduces friction and improves the setup experience for users
following the local quickstart by addressing feedback in #517 regarding
difficulties in the initial database connection step.
### Problem
Users faced issues like password prompts or "role 'postgres' does not
exist" errors when trying to connect to PostgreSQL with `psql -h
127.0.0.1 -U postgres`.
### Solution
This PR adds a notice that provides solutions for common connection
errors, including guidance on using `sudo -i -u postgres` for peer
authentication.
---------
Co-authored-by: Averi Kitsch <akitsch@google.com >
2025-05-06 11:24:59 +05:30
Jack Wotherspoon
8b68764ef6
docs: update wording and typos for AuthServices ( #525 )
...
The wording for `Authorized Invocations` reads a bit funny and has a
typo.
Updating it to make a bit more sense and fixing a couple other typos
around auth.
2025-05-05 16:24:03 +00:00
Jack Wotherspoon
c7189e9fcf
docs: use --tools-file over deprecated --tools_file ( #524 )
...
Updating docs to use the `--tools-file` flag over the now deprecated
`--tools_file`.
The new flag was added as of `v0.3.0` in #384
This change reduces confusion as current usage in docs results in
following message on startup of Toolbox server:
```sh
Flag --tools_file has been deprecated, please use --tools-file instead
```
Fixes #514
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
2025-05-05 16:16:40 +00:00
Jack Wotherspoon
8b635955fc
docs: update typo in MySQL tool ( #526 )
...
Updating description of MySQL tool to properly mention MySQL as it
has a typo and currently says SQL Server.
2025-05-05 10:10:59 -06:00
Andrew Brook
91cc3e366d
docs: replace 'product' with 'solution' ( #522 )
...
To better conform to Google Cloud terminology, Toolbox should be
referred to as a "solution" rather than a "product".
2025-05-02 17:40:32 -07:00
shyam-cb
d7390b06b7
feat: add Couchbase as Source and Tool ( #307 )
...
Added couchbase support to Genai Toolbox
---------
Co-authored-by: duwenxin <duwenxin@google.com >
2025-05-02 16:37:58 -04:00
Yuan
11ea7bc584
feat: add postgres-execute-sql tool ( #490 )
...
This tool can be used across all postgres sources.
`postgres-execute-sql` config is as below:
```
tools:
postgres_execute_sql_tool:
kind: "postgres-execute-sql"
source: my-alloydb-source // or any other sources that is compatible with this tool
description: Use this tool to execute sql.
```
The `postgres-execute-sql` tool takes one parameter. Example request as
follow:
```
curl -X POST -H "Content-Type: application/json" -d '{"sql": "SELECT 1"}' http://127.0.0.1:5000/api/tool/postgres_execute_sql_tool/invoke
```
2025-05-01 17:43:41 +00:00
Huan Chen
b2176c0e2f
docs: update bigquery samples ( #512 )
...
1. Updated ADK dependencies.
2. Fixed sample code for Toolbox + ADK usage.
3. Updated the BigQuery MCP quickstart file to properly show the images.
2025-05-01 10:10:24 -07:00
Andrew Brook
f629df642b
docs: update MCP Toolbox description ( #504 )
...
Minor edit to description of Toolbox to avoid some sensitivity around
production/enterprise suitability as that may imply compliance features
or guarantees which aren't suitable to an early stage product.
---------
Co-authored-by: Wenxin Du <117315983+duwenxin99@users.noreply.github.com >
Co-authored-by: Yuan Teoh <yuanteoh@google.com >
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
2025-04-29 13:52:59 -07:00
Huan Chen
570d7caf4d
docs: update title for bigquery docs ( #503 )
2025-04-29 15:08:57 -04:00
Huan Chen
9ba6235106
docs: Create samples folder and add BigQuery MCP guide ( #496 )
...
1. Create `samples` folder
2. Moved BQ samples into `samples`
3. Add BigQuery MCP guide
---------
Co-authored-by: Wenxin Du <117315983+duwenxin99@users.noreply.github.com >
2025-04-28 18:16:57 -04:00
Kurtis Van Gent
8646989f80
chore: Update SQLite-sql title ( #493 )
2025-04-25 22:55:55 +00:00
Kurtis Van Gent
d1c870c004
chore: update bigquery-sql title ( #492 )
2025-04-25 16:51:41 -06:00
Huan Chen
7add34b544
docs: Add BigQuery quickstart colab and guide ( #485 )
...
Co-authored-by: Wenxin Du <117315983+duwenxin99@users.noreply.github.com >
2025-04-25 16:48:57 -04:00
Wenxin Du
b8dd50aded
docs: Update IAM guide for Cloud SQL and AlloyDB ( #480 )
2025-04-25 15:27:12 -04:00
Kurtis Van Gent
a352045116
docs: update diagram to include more supported databases ( #478 )
2025-04-23 14:01:14 -06:00
release-please[bot]
4ed16ccd18
chore(main): release 0.4.0 ( #411 )
...
🤖 I have created a release *beep* *boop*
---
##
[0.4.0](https://github.com/googleapis/genai-toolbox/compare/v0.3.0...v0.4.0 )
(2025-04-23)
### Features
* Add `AuthRequired` to Neo4j & Dgraph Tools
([#434 ](https://github.com/googleapis/genai-toolbox/issues/434 ))
([afbf4b2afbf4b2dae#433 ](https://github.com/googleapis/genai-toolbox/issues/433 ))
([d9388add9388ad57e#463 ](https://github.com/googleapis/genai-toolbox/issues/463 ))
([8055aa58055aa519f#418 ](https://github.com/googleapis/genai-toolbox/issues/418 ))
([ae53b8eae53b8eeff#399 ](https://github.com/googleapis/genai-toolbox/issues/399 ))
([e8ed447e8ed447d91#414 ](https://github.com/googleapis/genai-toolbox/issues/414 ))
([be85b82be85b82078#425 ](https://github.com/googleapis/genai-toolbox/issues/425 ))
([e307857e307857085#403 ](https://github.com/googleapis/genai-toolbox/issues/403 )
* Add SQLite source and tool
([#438 ](https://github.com/googleapis/genai-toolbox/issues/438 ))
([fc14cbffc14cbfd07#462 ](https://github.com/googleapis/genai-toolbox/issues/462 ))
([eadb678eadb678a7b#419 ](https://github.com/googleapis/genai-toolbox/issues/419 ) TLS
https URL for SSE endpoint
([#420 ](https://github.com/googleapis/genai-toolbox/issues/420 ))
([0a7d3ff0a7d3ff06b#454 ](https://github.com/googleapis/genai-toolbox/issues/454 ))
([969065e969065e561#427 ](https://github.com/googleapis/genai-toolbox/issues/427 )
* Update http error code from invocation
([#468 ](https://github.com/googleapis/genai-toolbox/issues/468 ))
([ff7c0ffff7c0ffc65#465 ](https://github.com/googleapis/genai-toolbox/issues/465 )
---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please ). See
[documentation](https://github.com/googleapis/release-please#release-please ).
---------
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
Co-authored-by: Wenxin Du <117315983+duwenxin99@users.noreply.github.com >
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
2025-04-23 13:22:25 -04:00
Wenxin Du
eadb678a7b
feat: Support env replacement for tool.yaml ( #462 )
...
Environment variable replacement is needed so that users don't have to
hardcode their secrets in configuring `tools.yaml`.
Both formats `$ENV_NAME` and `${ENV_NAME}` are standard ways to declare
an environment variable.
However, some database statement placeholders that are already using the
`$ENV_NAME` format.
Therefore, we only support env var declaration using `${ENV_NAME}` to
disambiguate it from other usages.
Fixes issue: https://github.com/googleapis/genai-toolbox/issues/431
2025-04-23 07:33:02 -04:00
waqarahmed6095
fc14cbfd07
feat: sqlite implementation ( #438 )
...
Adding sqlite implementation
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
Co-authored-by: Yuan Teoh <yuanteoh@google.com >
2025-04-22 22:25:53 -07:00
Huan Chen
8055aa519f
feat: Add BigQuery source and tool ( #463 )
...
A `BigQuery` source can be added as the following example:
```yaml
sources:
my-bigquery-source:
kind: bigquery
project: bigframes-dev
location: us # This field is optional
```
A `BigQuery` tool can be added as below:
```yaml
tools:
search-hotels-by-name:
kind: bigquery-sql
source: my-bigquery-source
description: Search for hotels based on name.
parameters:
- name: name
type: string
description: The name of the hotel.
```
---------
Co-authored-by: Wenxin Du <117315983+duwenxin99@users.noreply.github.com >
2025-04-22 20:37:38 -06:00
Michael Hunger
53ce38021d
docs: add tested clients table ( #428 )
...
Added a table with supported clients for MCP Server
---------
Co-authored-by: Yuan <45984206+Yuan325@users.noreply.github.com >
Co-authored-by: Kurtis Van Gent <31518063+kurtisvg@users.noreply.github.com >
2025-04-22 10:11:52 -07:00
Twisha Bansal
ba1d52aa04
docs: add ADK to colab quickstart ( #459 )
2025-04-21 14:14:59 +00:00
