MCP Toolbox SDKs for Javascript

The @toolbox-sdk/adk package provides a Javascript interface to the MCP Toolbox service, specifically designed for seamless integration with Google ADK TS. It allows you to load tools defined in the Toolbox service and use them directly within your ADK agents and workflows.

For detailed guides, authentication examples, and advanced configuration, visit the JS SDK ADK Guide.

• MCP Toolbox SDKs for Javascript
• Supported Environments
  • Installation
  • Quickstart
  • Usage
• Contributing
• License
• Support

Supported Environments

This SDK is a standard Node.js package built with TypeScript, ensuring broad compatibility with the modern JavaScript ecosystem.

• Node.js: Actively supported on Node.js v18.x and higher. The package is compatible with both modern ES Modules (import) and legacy CommonJS (require).
• TypeScript: The SDK is written in TypeScript and ships with its own type declarations, providing a first-class development experience with autocompletion and type-checking out of the box.
• JavaScript: Fully supports modern JavaScript in Node.js environments.

Installation

npm install @toolbox-sdk/adk

Quickstart

Here's a minimal example to get you started. Ensure your Toolbox service is running and accessible.

import { ToolboxClient } from '@toolbox-sdk/adk';  
const client = new ToolboxClient(URL);  

async function quickstart() {  
  try {  
      const tools = await client.loadToolset();  
      // Use tools  
  } catch (error) {  
      console.error("unable to load toolset:", error.message);  
  }  
}  
quickstart();  

[!NOTE] This guide uses modern ES Module (import) syntax. If your project uses CommonJS, you can import the library using require: const { ToolboxClient } = require('@toolbox-sdk/adk');.

Usage

The core package provides a framework-agnostic way to interact with your MCP Toolbox server. For detailed guides and advanced configuration, please visit the following sections on our Documentation Site:

• Transport Protocols
• Loading Tools
• Invoking Tools
• Client to Server Authentication
• Authenticating Tools
• Binding Parameter Values

Contributing

Contributions are welcome! Please refer to the DEVELOPER.md file for guidelines on how to set up a development environment and run tests.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Support

If you encounter issues or have questions, check the existing GitHub Issues for the main Toolbox project.