The @toolbox-sdk/core package provides a Javascript interface to the MCP Toolbox service, enabling you to load and invoke tools from your own applications. It is framework-agnostic and designed to seamlessly integrate with popular orchestration frameworks like Langchain and Genkit.
For detailed guides, authentication examples, and advanced configuration, visit the JS SDK Core Guide.
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.
npm install @toolbox-sdk/coreHere's a minimal example to get you started. Ensure your Toolbox service is running and accessible.
import { ToolboxClient } from '@toolbox-sdk/core';
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/core');.
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
Contributions are welcome! Please refer to the DEVELOPER.md file for guidelines on how to set up a development environment and run tests.
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
If you encounter issues or have questions, check the existing GitHub Issues for the main Toolbox project.