Files
genai-toolbox/docs/en/getting-started/local_quickstart_js.md
Twisha Bansal e84a51b660 docs: make branding consistent across quickstart docs (#2498)
## 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>
2026-02-18 09:58:52 +00:00

3.2 KiB

title, type, weight, description
title type weight description
JS Quickstart (Local) docs 3 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

This guide assumes you have already done the following:

  1. Installed Node.js (v18 or higher).
  2. Installed PostgreSQL 16+ and the psql client.

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. (Optional) Initialize a Node.js project:

    npm init -y
    
  2. In a new terminal, install the SDK package. {{< tabpane persist=header >}} {{< tab header="LangChain" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="GenkitJS" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="LlamaIndex" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="GoogleGenAI" lang="bash" >}} npm install @toolbox-sdk/core {{< /tab >}} {{< tab header="ADK" lang="bash" >}} npm install @toolbox-sdk/adk {{< /tab >}} {{< /tabpane >}}

  3. Install other required dependencies

    {{< tabpane persist=header >}} {{< tab header="LangChain" lang="bash" >}} npm install langchain @langchain/google-genai {{< /tab >}} {{< tab header="GenkitJS" lang="bash" >}} npm install genkit @genkit-ai/googleai {{< /tab >}} {{< tab header="LlamaIndex" lang="bash" >}} npm install llamaindex @llamaindex/google @llamaindex/workflow {{< /tab >}} {{< tab header="GoogleGenAI" lang="bash" >}} npm install @google/genai {{< /tab >}} {{< tab header="ADK" lang="bash" >}} npm install @google/adk {{< /tab >}} {{< /tabpane >}}

  4. Create a new file named hotelAgent.js and copy the following code to create an agent:

    {{< tabpane persist=header >}} {{< tab header="LangChain" lang="js" >}}

{{< include "quickstart/js/langchain/quickstart.js" >}}

{{< /tab >}}

{{< tab header="GenkitJS" lang="js" >}}

{{< include "quickstart/js/genkit/quickstart.js" >}}

{{< /tab >}}

{{< tab header="LlamaIndex" lang="js" >}}

{{< include "quickstart/js/llamaindex/quickstart.js" >}}

{{< /tab >}}

{{< tab header="GoogleGenAI" lang="js" >}}

{{< include "quickstart/js/genAI/quickstart.js" >}}

{{< /tab >}}

{{< tab header="ADK" lang="js" >}}

{{< include "quickstart/js/adk/quickstart.js" >}}

{{< /tab >}}

{{< /tabpane >}}

  1. Run your agent, and observe the results:

    node hotelAgent.js
    

{{< notice info >}} For more information, visit the JS SDK repo. {{</ notice >}}