MCP Toolbox SDK (Go)
Go SDK for interacting with the MCP Toolbox for Databases.
What is MCP Toolbox SDK (Go)?
MCP Toolbox SDK (Go) is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to go sdk for interacting with the mcp toolbox for databases.
Go SDK for interacting with the MCP Toolbox for Databases.
This server falls under the Databases category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Go SDK for interacting with the MCP Toolbox for Databases.
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-toolbox-sdk-goConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Toolbox SDK (Go)
The MCP Toolbox SDK for Go is Google's official Go client library for interacting with MCP Toolbox for Databases — a server that exposes database operations as MCP-compatible tools. The SDK provides Go structs for tool definitions, handles authentication and parameter binding, and lets Go applications built with Genkit, ADK Go, or plain Go invoke database tools through the Toolbox instance. It is designed for teams building AI agents in Go that need safe, governed access to production databases without embedding raw SQL into prompts.
Prerequisites
- Go 1.21 or higher installed
- A running MCP Toolbox for Databases instance (see toolbox.googleapis.com for setup)
- A Go module initialized (go mod init) in your project
- Appropriate database credentials configured in your Toolbox instance
Choose and install the appropriate SDK module
The SDK has three modules: core (framework-agnostic), tbadk (for ADK Go), and tbgenkit (for Genkit Go). Install the one that matches your framework.
# Framework-agnostic core
go get github.com/googleapis/mcp-toolbox-sdk-go/core
# For Genkit Go
go get github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit
# For ADK Go
go get github.com/googleapis/mcp-toolbox-sdk-go/tbadkSet up and configure MCP Toolbox for Databases
The SDK is a client — it connects to a Toolbox server that you run separately. Follow the MCP Toolbox for Databases quickstart at toolbox.googleapis.com to start a Toolbox instance with your database configuration.
Import the SDK and create a client
Import the core package and create a client pointing at your running Toolbox instance URL.
import "github.com/googleapis/mcp-toolbox-sdk-go/core"
client, err := core.NewClient(ctx, "http://localhost:5000")
if err != nil {
log.Fatal(err)
}Load and invoke tools
Fetch tool definitions from the Toolbox instance and invoke them with parameters. The SDK handles serialization, authentication, and binding.
tools, err := client.LoadTools(ctx, []string{"search_products"})
if err != nil {
log.Fatal(err)
}
result, err := tools[0].Invoke(ctx, map[string]any{
"query": "laptop",
"limit": 10,
})Note: v0.6.0+ multi-module import paths
If upgrading from v0.5.1 or earlier, update your import paths to the new multi-module structure. The monorepo was restructured at v0.6.0 and old import paths no longer work.
# Old (pre-0.6.0)
import "github.com/googleapis/mcp-toolbox-sdk-go"
# New (0.6.0+)
import "github.com/googleapis/mcp-toolbox-sdk-go/core"MCP Toolbox SDK (Go) Examples
Client configuration
Example go.mod and core client initialization for a framework-agnostic Go application
// go.mod
module myapp
go 1.21
require github.com/googleapis/mcp-toolbox-sdk-go/core v0.6.0
// main.go
package main
import (
"context"
"github.com/googleapis/mcp-toolbox-sdk-go/core"
)
func main() {
ctx := context.Background()
client, _ := core.NewClient(ctx, "http://localhost:5000")
tools, _ := client.LoadToolset(ctx, "my-toolset")
_ = tools
}Prompts to try
Conceptual use cases for integrating the SDK into AI agent workflows
- "Load the search_products tool from Toolbox and query for items under $50"
- "Use the customer_lookup tool to retrieve account details for customer ID 12345"
- "Invoke the inventory_check tool with product SKU 'ABC-001' and return stock levels"
- "Fetch all available tools from my Toolbox instance and list their parameter schemas"
- "Call the create_order tool with the items from the shopping cart"Troubleshooting MCP Toolbox SDK (Go)
Import errors after upgrading to v0.6.0 or later
The SDK moved to a multi-module structure at v0.6.0. Update all imports from 'github.com/googleapis/mcp-toolbox-sdk-go' to the specific sub-module you need (e.g., '/core', '/tbgenkit', or '/tbadk'). Run 'go mod tidy' after updating imports.
Connection refused when calling client.LoadTools
The SDK connects to a running MCP Toolbox for Databases server — ensure your Toolbox instance is running and the URL passed to NewClient is correct. The default local port is typically 5000. Check the Toolbox server logs for startup errors.
Tool invocations fail with authentication errors against the database
Authentication is configured on the Toolbox server side, not in the SDK. Check your Toolbox configuration file for correct database credentials and ensure the Toolbox instance has network access to the database.
Frequently Asked Questions about MCP Toolbox SDK (Go)
What is MCP Toolbox SDK (Go)?
MCP Toolbox SDK (Go) is a Model Context Protocol (MCP) server that go sdk for interacting with the mcp toolbox for databases. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Toolbox SDK (Go)?
Follow the installation instructions on the MCP Toolbox SDK (Go) GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Toolbox SDK (Go)?
MCP Toolbox SDK (Go) works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Toolbox SDK (Go) free to use?
Yes, MCP Toolbox SDK (Go) is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
MCP Toolbox SDK (Go) Alternatives — Similar Databases Servers
Looking for alternatives to MCP Toolbox SDK (Go)? Here are other popular databases servers you can use with Claude, Cursor, and VS Code.
Excelize
★ 20.6kGo language library for reading and writing Microsoft Excel™ (XLAM / XLSM / XLSX / XLTM / XLTX) spreadsheets
MCP Toolbox for Databases
★ 15.3kOpen source MCP server specializing in easy, fast, and secure tools for Databases.
DBHub
★ 2.8kA universal database gateway MCP server that enables AI assistants to connect to and query multiple databases (PostgreSQL, MySQL, MariaDB, SQL Server, SQLite) with support for schema exploration, SQL execution, and secure connections via SSH tunnels.
Tabularis
★ 2.1kA lightweight, cross-platform database client for developers. Supports MySQL, PostgreSQL and SQLite. Hackable with plugins. Built for speed, security, and aesthetics.
Postgres AI Guide
★ 1.7kMCP server and Claude plugin for Postgres skills and documentation. Helps AI coding tools generate better PostgreSQL code.
Anyquery
★ 1.7k🏎️ 🏠 ☁️ - Query more than 40 apps with one binary using SQL. It can also connect to your PostgreSQL, MySQL, or SQLite compatible database. Local-first and private by design.
Browse More Databases MCP Servers
Explore all databases servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP Toolbox SDK (Go) in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Toolbox SDK (Go)?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.