This repository contains the Go SDK designed to seamlessly integrate the functionalities of the MCP Toolbox into your Gen AI applications. The SDK allow you to load tools defined in Toolbox and use them as standard Go tools within popular orchestration frameworks or your custom code.
This simplifies the process of incorporating external functionalities (like Databases or APIs) managed by Toolbox into your GenAI applications.
The MCP Toolbox service provides a centralized way to manage and expose tools (like API connectors, database query tools, etc.) for use by GenAI applications.
The Go SDK act as clients for that service. They handle the communication needed to:
By using the SDK, you can easily leverage your Toolbox-managed tools directly within your Go applications or AI orchestration frameworks.
Which Package Should I Use?Choosing the right package depends on how you are building your application:
core
: This is a framework agnostic way to connect the tools to popular frameworks like Google GenAI, LangChain, etc.
tbgenkit
: This package provides a functionality to convert the Tool fetched using the core package into a Genkit Go compatible tool.
This repository hosts the following Go packages. See the package-specific README for detailed installation and usage instructions:
Package Target Use Case Integration Path Details (README)core
Framework-agnostic / Custom applications Use directly / Custom core/
📄 View README tbgenkit
Genkit Go Along with core tbgenkit/
📄 View README
To get started using Toolbox tools with an application, follow these general steps:
Set up and Run the Toolbox Service:
Before using the SDKs, you need the MCP Toolbox server running. Follow the instructions here: Toolbox Getting Started Guide
Install the Appropriate SDK:
Choose the package based on your needs (see "Which Package Should I Use?" above) Use this command to install the SDK module
# For the core, framework-agnostic SDK go get github.com/googleapis/mcp-toolbox-sdk-go
Use the SDK:
Consult the README for your chosen package (linked in the "Available Packages" section above) for detailed instructions on how to connect the client, load tool definitions, invoke tools, configure authentication/binding, and integrate them into your application or framework.
Contributions are welcome! Please refer to the CONTRIBUTING.md
to get started.
This project is licensed under the Apache License 2.0. See the LICENSE file for details.
If you encounter issues or have questions, please check the existing GitHub Issues for the main Toolbox project. If your issue is specific to one of the SDKs, please look for existing issues here or open a new issue in this repository.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4