diff --git a/docs/en/getting-started/colab_quickstart.ipynb b/docs/en/getting-started/colab_quickstart.ipynb index a12429180dd..f08ac2cae74 100644 --- a/docs/en/getting-started/colab_quickstart.ipynb +++ b/docs/en/getting-started/colab_quickstart.ipynb @@ -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", - "\"Toolbox\n", + "\"MCP\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." ] diff --git a/docs/en/getting-started/local_quickstart.md b/docs/en/getting-started/local_quickstart.md index 414156f6721..50895678d11 100644 --- a/docs/en/getting-started/local_quickstart.md +++ b/docs/en/getting-started/local_quickstart.md @@ -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 ```
-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" >}} ``` diff --git a/docs/en/getting-started/local_quickstart_go.md b/docs/en/getting-started/local_quickstart_go.md index 09e6ef2ce54..401c23c89d1 100644 --- a/docs/en/getting-started/local_quickstart_go.md +++ b/docs/en/getting-started/local_quickstart_go.md @@ -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: diff --git a/docs/en/getting-started/local_quickstart_js.md b/docs/en/getting-started/local_quickstart_js.md index bfec5be5d9f..43f79cb4bf1 100644 --- a/docs/en/getting-started/local_quickstart_js.md +++ b/docs/en/getting-started/local_quickstart_js.md @@ -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: