Skip to content

Commit c22486b

Browse files
authored
Merge branch 'main' into adk-python-processing
2 parents 7f23059 + 64468c2 commit c22486b

24 files changed

Lines changed: 4797 additions & 91 deletions

File tree

.github/CODEOWNERS

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,15 +3,15 @@
33
# For syntax help see:
44
# https://help.github.com/en/github/creating-cloning-and-archiving-repositories/about-code-owners#codeowners-syntax
55

6-
* @googleapis/senseai-eco
6+
* @googleapis/senseai-eco-team
77
# Code & Tests
8-
**/alloydb*/ @googleapis/toolbox-alloydb
9-
**/bigquery/ @googleapis/toolbox-bigquery
10-
**/bigtable/ @googleapis/toolbox-bigtable
11-
**/cloudsqlmssql/ @googleapis/toolbox-cloud-sql-mssql
12-
**/cloudsqlmysql/ @googleapis/toolbox-cloud-sql-mysql
13-
**/cloudsqlpg/ @googleapis/toolbox-cloud-sql-postgres
14-
**/dataplex/ @googleapis/toolbox-dataplex
15-
**/firestore/ @googleapis/toolbox-firestore
16-
**/looker/ @googleapis/toolbox-looker
17-
**/spanner/ @googleapis/toolbox-spanner
8+
**/alloydb*/ @googleapis/toolbox-alloydb-team
9+
**/bigquery/ @googleapis/toolbox-bigquery-team
10+
**/bigtable/ @googleapis/toolbox-bigtable-team
11+
**/cloudsqlmssql/ @googleapis/toolbox-cloud-sql-mssql-team
12+
**/cloudsqlmysql/ @googleapis/toolbox-cloud-sql-mysql-team
13+
**/cloudsqlpg/ @googleapis/toolbox-cloud-sql-postgres-team
14+
**/dataplex/ @googleapis/toolbox-dataplex-team
15+
**/firestore/ @googleapis/toolbox-firestore-team
16+
**/looker/ @googleapis/toolbox-looker-team
17+
**/spanner/ @googleapis/toolbox-spanner-team

.github/blunderbuss.yml

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -22,85 +22,85 @@ assign_issues_by:
2222
- labels:
2323
- 'product: alloydb'
2424
to:
25-
- 'googleapis/toolbox-alloydb'
25+
- 'googleapis/toolbox-alloydb-team'
2626
- labels:
2727
- 'product: bigquery'
2828
to:
29-
- 'googleapis/toolbox-bigquery'
29+
- 'googleapis/toolbox-bigquery-team'
3030
- labels:
3131
- 'product: bigtable'
3232
to:
33-
- 'googleapis/toolbox-bigtable'
33+
- 'googleapis/toolbox-bigtable-team'
3434
- labels:
3535
- 'product: mssql'
3636
to:
37-
- 'googleapis/toolbox-cloud-sql-mssql'
37+
- 'googleapis/toolbox-cloud-sql-mssql-team'
3838
- labels:
3939
- 'product: mysql'
4040
to:
41-
- 'googleapis/toolbox-cloud-sql-mysql'
41+
- 'googleapis/toolbox-cloud-sql-mysql-team'
4242
- labels:
4343
- 'product: postgres'
4444
to:
45-
- 'googleapis/toolbox-cloud-sql-postgres'
45+
- 'googleapis/toolbox-cloud-sql-postgres-team'
4646
- labels:
4747
- 'product: dataplex'
4848
to:
49-
- 'googleapis/toolbox-dataplex'
49+
- 'googleapis/toolbox-dataplex-team'
5050
- labels:
5151
- 'product: firestore'
5252
to:
53-
- 'googleapis/toolbox-firestore'
53+
- 'googleapis/toolbox-firestore-team'
5454
- labels:
5555
- 'product: looker'
5656
to:
57-
- 'googleapis/toolbox-looker'
57+
- 'googleapis/toolbox-looker-team'
5858
- labels:
5959
- 'product: spanner'
6060
to:
61-
- 'googleapis/toolbox-spanner'
61+
- 'googleapis/toolbox-spanner-team'
6262
assign_prs:
6363
- Yuan325
6464
- duwenxin99
6565
assign_prs_by:
6666
- labels:
6767
- 'product: alloydb'
6868
to:
69-
- 'googleapis/toolbox-alloydb'
69+
- 'googleapis/toolbox-alloydb-team'
7070
- labels:
7171
- 'product: bigquery'
7272
to:
73-
- 'googleapis/toolbox-bigquery'
73+
- 'googleapis/toolbox-bigquery-team'
7474
- labels:
7575
- 'product: bigtable'
7676
to:
77-
- 'googleapis/toolbox-bigtable'
77+
- 'googleapis/toolbox-bigtable-team'
7878
- labels:
7979
- 'product: mssql'
8080
to:
81-
- 'googleapis/toolbox-cloud-sql-mssql'
81+
- 'googleapis/toolbox-cloud-sql-mssql-team'
8282
- labels:
8383
- 'product: mysql'
8484
to:
85-
- 'googleapis/toolbox-cloud-sql-mysql'
85+
- 'googleapis/toolbox-cloud-sql-mysql-team'
8686
- labels:
8787
- 'product: postgres'
8888
to:
89-
- 'googleapis/toolbox-cloud-sql-postgres'
89+
- 'googleapis/toolbox-cloud-sql-postgres-team'
9090
- labels:
9191
- 'product: dataplex'
9292
to:
93-
- 'googleapis/toolbox-dataplex'
93+
- 'googleapis/toolbox-dataplex-team'
9494
- labels:
9595
- 'product: firestore'
9696
to:
97-
- 'googleapis/toolbox-firestore'
97+
- 'googleapis/toolbox-firestore-team'
9898
- labels:
9999
- 'product: looker'
100100
to:
101-
- 'googleapis/toolbox-looker'
101+
- 'googleapis/toolbox-looker-team'
102102
- labels:
103103
- 'product: spanner'
104104
to:
105-
- 'googleapis/toolbox-spanner'
105+
- 'googleapis/toolbox-spanner-team'
106106

.github/workflows/lint.yaml

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,20 @@
1515
name: lint
1616
on:
1717
pull_request:
18+
paths:
19+
- "**"
20+
- "!docs/**"
21+
- "!**.md"
22+
- "!.github/**"
23+
- ".github/workflows/lint.yaml"
1824
pull_request_target:
1925
types: [labeled]
26+
paths:
27+
- "**"
28+
- "!docs/**"
29+
- "!**.md"
30+
- "!.github/**"
31+
- ".github/workflows/lint.yaml"
2032

2133
# Declare default permissions as read only.
2234
permissions: read-all
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# Copyright 2026 Google LLC
2+
#
3+
# Licensed under the Apache License, Version 2.0 (the "License");
4+
# you may not use this file except in compliance with the License.
5+
# You may obtain a copy of the License at
6+
#
7+
# http://www.apache.org/licenses/LICENSE-2.0
8+
#
9+
# Unless required by applicable law or agreed to in writing, software
10+
# distributed under the License is distributed on an "AS IS" BASIS,
11+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
# See the License for the specific language governing permissions and
13+
# limitations under the License.
14+
15+
name: lint
16+
17+
on:
18+
pull_request:
19+
paths:
20+
- "docs/**"
21+
- "**.md"
22+
- ".github/**"
23+
- "!.github/workflows/lint.yaml"
24+
pull_request_target:
25+
paths:
26+
- "docs/**"
27+
- "**.md"
28+
- ".github/**"
29+
- "!.github/workflows/lint.yaml"
30+
31+
permissions: read-all
32+
33+
jobs:
34+
lint:
35+
name: lint
36+
runs-on: ubuntu-latest
37+
steps:
38+
- name: Skip Lint
39+
run: |
40+
echo "Skipping lint for documentation/config-only changes."
41+
echo "This job exists to satisfy the required status check."

docs/en/sdks/JS-sdk/_index.md

Lines changed: 71 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,71 @@
1+
---
2+
title: "Javascript"
3+
type: docs
4+
weight: 2
5+
description: >
6+
Javascript SDKs to connect to the MCP Toolbox server.
7+
---
8+
9+
## Overview
10+
11+
The MCP Toolbox service provides a centralized way to manage and expose tools
12+
(like API connectors, database query tools, etc.) for use by GenAI applications.
13+
14+
These JS SDKs act as clients for that service. They handle the communication needed to:
15+
16+
* Fetch tool definitions from your running Toolbox instance.
17+
* Provide convenient JS objects or functions representing those tools.
18+
* Invoke the tools (calling the underlying APIs/services configured in Toolbox).
19+
* Handle authentication and parameter binding as needed.
20+
21+
By using these SDKs, you can easily leverage your Toolbox-managed tools directly
22+
within your JS applications or AI orchestration frameworks.
23+
24+
## Which Package Should I Use?
25+
26+
Choosing the right package depends on how you are building your application:
27+
28+
- [`@toolbox-sdk/core`](https://github.com/googleapis/mcp-toolbox-sdk-js/tree/main/packages/toolbox-core):
29+
This is a framework agnostic way to connect the tools to popular frameworks
30+
like Langchain, LlamaIndex and Genkit.
31+
- [`@toolbox-sdk/adk`](https://github.com/googleapis/mcp-toolbox-sdk-js/tree/main/packages/toolbox-adk):
32+
This package provides a seamless way to connect to [Google ADK TS](https://github.com/google/adk-js).
33+
34+
## Available Packages
35+
36+
This repository hosts the following TS packages. See the package-specific
37+
README for detailed installation and usage instructions:
38+
39+
| Package | Target Use Case | Integration | Path | Details (README) | Npm Version |
40+
| :------ | :---------- | :---------- | :---------------------- | :---------- | :---------- |
41+
| `toolbox-core` | Framework-agnostic / Custom applications | Use directly / Custom | `packages/toolbox-core/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-core/README.md) | ![npm](https://img.shields.io/npm/v/@toolbox-sdk/core) |
42+
| `toolbox-adk` | ADK applications | ADK | `packages/toolbox-adk/` | 📄 [View README](https://github.com/googleapis/mcp-toolbox-sdk-js/blob/main/packages/toolbox-adk/README.md) | ![npm](https://img.shields.io/npm/v/@toolbox-sdk/adk) |
43+
44+
45+
## Getting Started
46+
47+
To get started using Toolbox tools with an application, follow these general steps:
48+
49+
1. **Set up and Run the Toolbox Service:**
50+
51+
Before using the SDKs, you need the main MCP Toolbox service running. Follow
52+
the instructions here: [**Toolbox Getting Started
53+
Guide**](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started)
54+
55+
2. **Install the Appropriate SDK:**
56+
57+
Choose the package based on your needs (see "[Which Package Should I Use?](#which-package-should-i-use)" above) and install it:
58+
59+
```bash
60+
# For the core, framework-agnostic SDK
61+
npm install @toolbox-sdk/core
62+
63+
# For ADK applications
64+
npm install @toolbox-sdk/adk
65+
```
66+
67+
68+
69+
{{< notice note >}}
70+
Source code for [js-sdk](https://github.com/googleapis/mcp-toolbox-sdk-js)
71+
{{< /notice >}}

0 commit comments

Comments
 (0)