You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This repository contains JS SDKs designed to seamlessly integrate the
13
-
functionalities of the [MCP
14
-
Toolbox](https://github.com/googleapis/genai-toolbox) into your Gen AI
15
-
applications. These SDKs allow you to load tools defined in Toolbox and use them
16
-
as standard JS functions or objects within popular orchestration frameworks
17
-
or your custom code.
12
+
This repository contains JavaScript SDKs for [MCP Toolbox](https://github.com/googleapis/genai-toolbox). These SDKs allow you to load and use tools defined in your MCP Toolbox server as standard JS functions or objects within your Agentic applications.
18
13
19
-
This simplifies the process of incorporating external functionalities (like
20
-
Databases or APIs) managed by Toolbox into your GenAI applications.
14
+
For comprehensive guides, tutorials, and advanced configuration, visit the [Main Documentation Site](https://googleapis.github.io/genai-toolbox/).
21
15
22
16
<!-- TOC -->
23
17
24
-
-[Overview](#overview)
25
-
-[Which Package Should I Use?](#which-package-should-i-use)
26
18
-[Available Packages](#available-packages)
27
-
-[Getting Started](#getting-started)
19
+
-[Quick Start](#quick-start)
28
20
-[Contributing](#contributing)
29
21
-[License](#license)
30
22
-[Support](#support)
31
23
32
24
<!-- /TOC -->
33
25
34
-
## Overview
35
-
36
-
The MCP Toolbox service provides a centralized way to manage and expose tools
37
-
(like API connectors, database query tools, etc.) for use by GenAI applications.
38
-
39
-
These JS SDKs act as clients for that service. They handle the communication needed to:
40
-
41
-
* Fetch tool definitions from your running Toolbox instance.
42
-
* Provide convenient JS objects or functions representing those tools.
43
-
* Invoke the tools (calling the underlying APIs/services configured in Toolbox).
44
-
* Handle authentication and parameter binding as needed.
45
-
46
-
By using these SDKs, you can easily leverage your Toolbox-managed tools directly
47
-
within your JS applications or AI orchestration frameworks.
48
-
49
-
## Which Package Should I Use?
50
-
51
-
Choosing the right package depends on how you are building your application:
This repository hosts the following TS packages. Visit the [Main Documentation Site](https://googleapis.github.io/genai-toolbox/sdks/js-sdk/) for detailed installation and usage instructions:
68
29
69
-
## Getting Started
30
+
| Package | Target Use Case | Path | Documentation |
Choose the package based on your needs (see "[Which Package Should I Use?](#which-package-should-i-use)" above) and install it:
35
+
## Quick Start
82
36
37
+
1.**Set up the Toolbox Service**: Ensure you have a running MCP Toolbox server. Follow the [Toolbox Server Getting Started Guide](https://github.com/googleapis/genai-toolbox?tab=readme-ov-file#getting-started).
38
+
2.**Install the Appropriate SDK**:
83
39
```bash
84
40
# For the core, framework-agnostic SDK
85
41
npm install @toolbox-sdk/core
86
42
```
87
-
88
-
3. **Use the SDK:**
89
-
90
-
Consult the README foryour chosen package (linkedin the "[Available
91
-
Packages](#available-packages)" section above) for detailed instructions on
92
-
how to connect the client, load tool definitions, invoke tools, configure
93
-
authentication/binding, and integrate them into your application or
94
-
framework.
95
-
43
+
```bash
44
+
# For the ADK SDK
45
+
npm install @toolbox-sdk/adk
46
+
```
47
+
3. **Explore Tutorials**: Check out the [JS Quickstart Tutorial](https://googleapis.github.io/genai-toolbox/getting-started/local_quickstart_js/) for a full walkthrough.
0 commit comments