Skillget

mcp-toolbox-sdk-go

mcp
SUMMARY

Go SDK for interacting with the MCP Toolbox for Databases.

README.md

MCP ToolboxLogo

MCP Toolbox SDKs for Go

License: Apache2.0
Docs
Discord
Medium

Core Module :
Go Report Card
Module Version
Go Version

TBADK Module :
Go Report Card
Module Version
Go Version

TBGenkit Module :
Go Report Card
Module Version
Go Version

[!IMPORTANT]
Breaking Change Notice: As of version 0.6.0, this repository has transitioned to a multi-module structure.

  • For new versions (v0.6.0+): You must import specific modules (e.g., go get github.com/googleapis/mcp-toolbox-sdk-go/core).
  • For older versions (v0.5.1 and below): The repository remains a single-module library (go get github.com/googleapis/mcp-toolbox-sdk-go).
  • Please update your imports and go.mod accordingly when upgrading.

This repository contains the Go SDKs for MCP Toolbox. These SDKs allow you to load and use tools defined in your MCP Toolbox server as standard Go structs within your Agentic applications.

For comprehensive guides and advanced configuration, visit the Main Documentation Site.

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 MCP Toolbox-managed tools directly
within your Go applications or AI orchestration frameworks.

Available Packages

This repository hosts the following Go packages. See the package-specific
README for detailed installation and usage instructions:

Package Target Use Case Path Documentation
core Framework-agnostic / Custom apps core/ Go SDK Core Guide
tbadk ADK Go Integration tbadk/ ADK Package Guide
tbgenkit Genkit Go Integration tbgenkit/ Genkit Package Guide

Quick Start

  1. Set up the Toolbox Service: Ensure you have a running MCP Toolbox server. Follow the MCP Toolbox Server Quickstart.
  2. Install the Appropriate SDK:
    # For the core, framework-agnostic SDK
go get github.com/googleapis/mcp-toolbox-sdk-go/core

# For ADK Go
go get github.com/googleapis/mcp-toolbox-sdk-go/tbadk

# For Genkit Go
go get github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit
  3. Explore Tutorials: Check out the Go Quickstart Tutorial for a full walkthrough.

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.

Reviews (0)

No results found