mcp-toolbox-sdk-go

MCP Toolbox SDKs for Go

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.

• Overview
• Which Package Should I Use?
• Available Packages
• Getting Started
• Contributing
• License
• Support

Overview

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:

• Fetch tool definitions from your running Toolbox instance.
• Provide convenient Go structs representing those tools.
• Invoke the tools (calling the underlying APIs/services configured in Toolbox).
• Handle authentication and parameter binding as needed.

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.

Available Packages

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

Getting Started

To get started using Toolbox tools with an application, follow these general steps:

1. 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

2. 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
   

3. 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.

Contributing

Contributions are welcome! Please refer to the
CONTRIBUTING.md
to get started.

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, 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.