mirror of
https://github.com/googleapis/genai-toolbox.git
synced 2026-05-02 03:00:36 -04:00
e84a51b660
## Description > Should include a concise description of the changes (bug or feature), it's > impact, along with a summary of the solution ## PR Checklist > Thank you for opening a Pull Request! Before submitting your PR, there are a > few things you can do to make sure it goes smoothly: - [ ] Make sure you reviewed [CONTRIBUTING.md](https://github.com/googleapis/genai-toolbox/blob/main/CONTRIBUTING.md) - [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/genai-toolbox/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea - [ ] Ensure the tests and linter pass - [ ] Code coverage does not decrease (if any source code was changed) - [ ] Appropriate docs were updated (if necessary) - [ ] Make sure to add `!` if this involve a breaking change 🛠️ Fixes #<issue_number_goes_here>
125 lines
3.5 KiB
Markdown
125 lines
3.5 KiB
Markdown
---
|
|
title: "Go Quickstart (Local)"
|
|
type: docs
|
|
weight: 4
|
|
description: >
|
|
How to get started running MCP Toolbox locally with [Go](https://github.com/googleapis/mcp-toolbox-sdk-go), PostgreSQL, and orchestration frameworks such as [LangChain Go](https://tmc.github.io/langchaingo/docs/), [GenkitGo](https://genkit.dev/go/docs/get-started-go/), [Go GenAI](https://github.com/googleapis/go-genai) and [OpenAI Go](https://github.com/openai/openai-go).
|
|
---
|
|
|
|
## Before you begin
|
|
|
|
This guide assumes you have already done the following:
|
|
|
|
1. Installed [Go (v1.24.2 or higher)].
|
|
1. Installed [PostgreSQL 16+ and the `psql` client][install-postgres].
|
|
|
|
[Go (v1.24.2 or higher)]: https://go.dev/doc/install
|
|
[install-postgres]: https://www.postgresql.org/download/
|
|
|
|
### Cloud Setup (Optional)
|
|
|
|
{{< regionInclude "quickstart/shared/cloud_setup.md" "cloud_setup" >}}
|
|
|
|
## Step 1: Set up your database
|
|
|
|
{{< regionInclude "quickstart/shared/database_setup.md" "database_setup" >}}
|
|
|
|
## Step 2: Install and configure MCP Toolbox
|
|
|
|
{{< regionInclude "quickstart/shared/configure_toolbox.md" "configure_toolbox" >}}
|
|
|
|
## Step 3: Connect your agent to MCP Toolbox
|
|
|
|
In this section, we will write and run an agent that will load the Tools
|
|
from MCP Toolbox.
|
|
|
|
1. Initialize a go module:
|
|
|
|
```bash
|
|
go mod init main
|
|
```
|
|
|
|
1. In a new terminal, install the Go SDK Module:
|
|
{{< notice warning >}}
|
|
Breaking Change Notice: As of version `0.6.0`, this SDK 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 SDK remains a single-module library (`go get github.com/googleapis/mcp-toolbox-sdk-go`).
|
|
* Please update your imports and `go.mod` accordingly when upgrading.
|
|
{{< /notice >}}
|
|
|
|
{{< tabpane persist=header >}}
|
|
{{< tab header="LangChain Go" lang="bash" >}}
|
|
go get github.com/googleapis/mcp-toolbox-sdk-go/core
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="Genkit Go" lang="bash" >}}
|
|
go get github.com/googleapis/mcp-toolbox-sdk-go/core
|
|
go get github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="Go GenAI" lang="bash" >}}
|
|
go get github.com/googleapis/mcp-toolbox-sdk-go/core
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="OpenAI Go" lang="bash" >}}
|
|
go get github.com/googleapis/mcp-toolbox-sdk-go/core
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="ADK Go" lang="bash" >}}
|
|
go get github.com/googleapis/mcp-toolbox-sdk-go/core
|
|
go get github.com/googleapis/mcp-toolbox-sdk-go/tbadk
|
|
{{< /tab >}}
|
|
{{< /tabpane >}}
|
|
|
|
2. Create a new file named `hotelagent.go` and copy the following code to create
|
|
an agent:
|
|
|
|
{{< tabpane persist=header >}}
|
|
{{< tab header="LangChain Go" lang="go" >}}
|
|
|
|
{{< include "quickstart/go/langchain/quickstart.go" >}}
|
|
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="Genkit Go" lang="go" >}}
|
|
|
|
{{< include "quickstart/go/genkit/quickstart.go" >}}
|
|
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="Go GenAI" lang="go" >}}
|
|
|
|
{{< include "quickstart/go/genAI/quickstart.go" >}}
|
|
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="OpenAI Go" lang="go" >}}
|
|
|
|
{{< include "quickstart/go/openAI/quickstart.go" >}}
|
|
|
|
{{< /tab >}}
|
|
|
|
{{< tab header="ADK Go" lang="go" >}}
|
|
|
|
{{< include "quickstart/go/adkgo/quickstart.go" >}}
|
|
|
|
{{< /tab >}}
|
|
{{< /tabpane >}}
|
|
|
|
1. Ensure all dependencies are installed:
|
|
|
|
```sh
|
|
go mod tidy
|
|
```
|
|
|
|
2. Run your agent, and observe the results:
|
|
|
|
```sh
|
|
go run hotelagent.go
|
|
```
|
|
|
|
{{< notice info >}}
|
|
For more information, visit the [Go SDK
|
|
repo](https://github.com/googleapis/mcp-toolbox-sdk-go).
|
|
{{</ notice >}}
|