github/genai-toolbox
1
0
Fork 0
mirror of https://github.com/googleapis/genai-toolbox.git synced 2026-02-18 11:02:26 -05:00
Code Issues Packages Projects Releases 14 Wiki Activity

Merge branch 'main' into adk-python-processing

Browse Source
This commit is contained in:
Twisha Bansal
2026-02-18 15:31:43 +05:30
committed by GitHub
parent 1a62677717 e84a51b660
commit a206f1afb6
4 changed files with 36 additions and 36 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
docs/en/getting-started/colab_quickstart.ipynb
View File

@@ -41,7 +41,7 @@
"# Getting Started With MCP Toolbox\n",
"\n",
"This guide demonstrates how to quickly run\n",
"[Toolbox](https://github.com/googleapis/genai-toolbox) end-to-end in Google\n",
"[MCP Toolbox](https://github.com/googleapis/genai-toolbox) end-to-end in Google\n",
"Colab using Python, PostgreSQL, and either [Google\n",
"GenAI](https://pypi.org/project/google-genai/), [ADK](https://google.github.io/adk-docs/),\n",
"[Langgraph](https://www.langchain.com/langgraph)\n",
@@ -49,12 +49,12 @@
"\n",
"Within this Colab environment, you'll\n",
"- Set up a `PostgreSQL database`.\n",
"- Launch a Toolbox server.\n",
"- Connect to Toolbox and develop a sample `Hotel Booking` application.\n",
"- Launch an MCP Toolbox server.\n",
"- Connect to MCP Toolbox and develop a sample `Hotel Booking` application.\n",
"\n",
"Here is the simplified flow of a Toolbox Application:\n",
"Here is the simplified flow of a MCP Toolbox Application:\n",
"\n",
"<img src=\"https://services.google.com/fh/files/misc/toolbox_flow.png\" alt=\"Toolbox Flow\"/>\n",
"<img src=\"https://services.google.com/fh/files/misc/toolbox_flow.png\" alt=\"MCP Toolbox Flow\"/>\n",
"\n"
]
},
@@ -208,12 +208,12 @@
"id": "EPuheP8DIt3p"
},
"source": [
"## Step 2: Install and configure Toolbox\n",
"## Step 2: Install and configure MCP Toolbox\n",
"\n",
"In this section, we will\n",
"1. Download the latest version of the toolbox binary.\n",
"2. Create a toolbox config file.\n",
"3. Start a toolbox server using the config file.\n",
"1. Download the latest version of the MCP toolbox binary.\n",
"2. Create an MCP toolbox config file.\n",
"3. Start an MCP toolbox server using the config file.\n",
"\n"
]
},
@@ -223,7 +223,7 @@
"id": "Bl1IeaqZbMYh"
},
"source": [
"Download the [latest](https://github.com/googleapis/genai-toolbox/releases) version of Toolbox as a binary."
"Download the [latest](https://github.com/googleapis/genai-toolbox/releases) version of MCP Toolbox as a binary."
]
},
{
@@ -284,7 +284,7 @@
"\n",
"Our application will leverage these tools to interact with the hotels database.\n",
"\n",
"For detailed configuration options, please refer to the [Toolbox documentation](https://googleapis.github.io/genai-toolbox/getting-started/configure/).\n",
"For detailed configuration options, please refer to the [MCP Toolbox documentation](https://googleapis.github.io/genai-toolbox/getting-started/configure/).\n",
"\n"
]
},
@@ -297,7 +297,7 @@
"outputs": [],
"source": [
"# Create a tools file at runtime.\n",
"# You can also upload a tools file and use that to run toolbox.\n",
"# You can also upload a tools file and use that to run MCP toolbox.\n",
"tools_file_name = \"tools.yml\"\n",
"file_content = f\"\"\"\n",
"kind: sources\n",
@@ -417,7 +417,7 @@
},
"outputs": [],
"source": [
"# Start a toolbox server\n",
"# Start an MCP toolbox server\n",
"! nohup {TOOLBOX_BINARY_PATH} --tools-file {TOOLS_FILE_PATH} -p {SERVER_PORT} > toolbox.log 2>&1 &"
]
},
@@ -429,7 +429,7 @@
},
"outputs": [],
"source": [
"# Check if toolbox is running\n",
"# Check if MCP toolbox is running\n",
"!sudo lsof -i :{SERVER_PORT}"
]
},
@@ -439,10 +439,10 @@
"id": "4yFH4JK7JEAv"
},
"source": [
"## Step 3: Connect your agent to Toolbox\n",
"## Step 3: Connect your agent to MCP Toolbox\n",
"\n",
"In this section, you will\n",
"1. Establish a connection to the tools by creating a Toolbox client.\n",
"1. Establish a connection to the tools by creating an MCP Toolbox client.\n",
"2. Build an agent that leverages the tools and an LLM for Hotel Booking functionality.\n"
]
},
@@ -495,7 +495,7 @@
"id": "J46eLkFbNhWq"
},
"source": [
"> You can either use LangGraph or LlamaIndex to develop a Toolbox based\n",
"> You can either use LangGraph or LlamaIndex to develop an MCP Toolbox based\n",
"> application. Run one of the sections below\n",
"> - [Connect using Google GenAI](#scrollTo=Fv2-uT4mvYtp)\n",
"> - [Connect using ADK](#scrollTo=QqRlWqvYNKSo)\n",
@@ -618,7 +618,7 @@
},
"outputs": [],
"source": [
"# Install the Toolbox Langchain package\n",
"# Install the MCP Toolbox Langchain package\n",
"!pip install toolbox-langchain --quiet\n",
"!pip install langgraph --quiet\n",
"\n",
@@ -679,7 +679,7 @@
" # model = ChatGoogleGenerativeAI(model=\"gemini-2.0-flash-001\")\n",
" # model = ChatAnthropic(model=\"claude-3-5-sonnet-20240620\")\n",
"\n",
" # Load the tools from the Toolbox server\n",
" # Load the tools from the MCP Toolbox server\n",
" client = ToolboxClient(\"http://127.0.0.1:5000\")\n",
" tools = await client.aload_toolset()\n",
"\n",
@@ -711,7 +711,7 @@
},
"outputs": [],
"source": [
"# Install the Toolbox LlamaIndex package\n",
"# Install the MCP Toolbox LlamaIndex package\n",
"!pip install toolbox-llamaindex --quiet\n",
"\n",
"# Install the llamaindex llm package\n",
@@ -783,7 +783,7 @@
" # api_key=os.getenv(\"ANTHROPIC_API_KEY\")\n",
" # )\n",
"\n",
" # Load the tools from the Toolbox server\n",
" # Load the tools from the MCP Toolbox server\n",
" client = ToolboxClient(\"http://127.0.0.1:5000\")\n",
" tools = await client.aload_toolset()\n",
"\n",
@@ -821,7 +821,7 @@
},
"outputs": [],
"source": [
"# Install the Toolbox Core package\n",
"# Install the MCP Toolbox Core package\n",
"!pip install toolbox-core --quiet\n",
"\n",
"# Install the Google GenAI package\n",
@@ -999,7 +999,7 @@
"id": "yatf9YoGclV9"
},
"source": [
"Executing this will terminate the processes running on the database and Toolbox ports.\n",
"Executing this will terminate the processes running on the database and MCP Toolbox ports.\n",
"\n",
"This is necessary before re-running the startup cells for these services to prevent `port already in use` errors."
]

10
docs/en/getting-started/local_quickstart.md
View File

@@ -3,7 +3,7 @@ title: "Python Quickstart (Local)"
type: docs
weight: 2
description: >
How to get started running Toolbox locally with [Python](https://github.com/googleapis/mcp-toolbox-sdk-python), PostgreSQL, and [Agent Development Kit](https://google.github.io/adk-docs/),
How to get started running MCP Toolbox locally with [Python](https://github.com/googleapis/mcp-toolbox-sdk-python), PostgreSQL, and [Agent Development Kit](https://google.github.io/adk-docs/),
[LangGraph](https://www.langchain.com/langgraph), [LlamaIndex](https://www.llamaindex.ai/) or [GoogleGenAI](https://pypi.org/project/google-genai/).
---
@@ -32,14 +32,14 @@ This guide assumes you have already done the following:
{{< regionInclude "quickstart/shared/database_setup.md" "database_setup" >}}
## Step 2: Install and configure Toolbox
## Step 2: Install and configure MCP Toolbox
{{< regionInclude "quickstart/shared/configure_toolbox.md" "configure_toolbox" >}}
## Step 3: Connect your agent to 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 Toolbox.
from MCP Toolbox.
{{< notice tip>}}
If you prefer to experiment within a Google Colab environment, you can connect
@@ -113,7 +113,7 @@ pip install google-genai
```
<br/>
1. Update `my_agent/agent.py` with the following content to connect to Toolbox:
1. Update `my_agent/agent.py` with the following content to connect to MCP Toolbox:
```py
{{< regionInclude "quickstart/python/adk/quickstart.py" "quickstart" >}}
```

8
docs/en/getting-started/local_quickstart_go.md
View File

@@ -3,7 +3,7 @@ title: "Go Quickstart (Local)"
type: docs
weight: 4
description: >
How to get started running 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).
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
@@ -24,14 +24,14 @@ This guide assumes you have already done the following:
{{< regionInclude "quickstart/shared/database_setup.md" "database_setup" >}}
## Step 2: Install and configure Toolbox
## Step 2: Install and configure MCP Toolbox
{{< regionInclude "quickstart/shared/configure_toolbox.md" "configure_toolbox" >}}
## Step 3: Connect your agent to 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 Toolbox.
from MCP Toolbox.
1. Initialize a go module:

8
docs/en/getting-started/local_quickstart_js.md
View File

@@ -3,7 +3,7 @@ title: "JS Quickstart (Local)"
type: docs
weight: 3
description: >
How to get started running Toolbox locally with [JavaScript](https://github.com/googleapis/mcp-toolbox-sdk-js), PostgreSQL, and orchestration frameworks such as [LangChain](https://js.langchain.com/docs/introduction/), [GenkitJS](https://genkit.dev/docs/get-started/), [LlamaIndex](https://ts.llamaindex.ai/) and [GoogleGenAI](https://github.com/googleapis/js-genai).
How to get started running MCP Toolbox locally with [JavaScript](https://github.com/googleapis/mcp-toolbox-sdk-js), PostgreSQL, and orchestration frameworks such as [LangChain](https://js.langchain.com/docs/introduction/), [GenkitJS](https://genkit.dev/docs/get-started/), [LlamaIndex](https://ts.llamaindex.ai/) and [GoogleGenAI](https://github.com/googleapis/js-genai).
---
## Before you begin
@@ -24,14 +24,14 @@ This guide assumes you have already done the following:
{{< regionInclude "quickstart/shared/database_setup.md" "database_setup" >}}
## Step 2: Install and configure Toolbox
## Step 2: Install and configure MCP Toolbox
{{< regionInclude "quickstart/shared/configure_toolbox.md" "configure_toolbox" >}}
## Step 3: Connect your agent to 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 Toolbox.
from MCP Toolbox.
1. (Optional) Initialize a Node.js project: