MCP Toolbox for Databases

Để cài đặt Toolbox dưới dạng tệp nhị phân:

Linux (AMD64)

Để cài đặt Toolbox dưới dạng tệp nhị phân trên Linux (AMD64):

# xem trang phát hành để biết các phiên bản khác
export VERSION=1.15.0
curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/linux/amd64/toolbox
chmod +x toolbox

macOS (Apple Silicon)

Để cài đặt Toolbox dưới dạng tệp nhị phân trên macOS (Apple Silicon):

# xem trang phát hành để biết các phiên bản khác
export VERSION=1.15.0
curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/darwin/arm64/toolbox
chmod +x toolbox

macOS (Intel)

Để cài đặt Toolbox dưới dạng tệp nhị phân trên macOS (Intel):

# xem trang phát hành để biết các phiên bản khác
export VERSION=1.15.0
curl -L -o toolbox https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/darwin/amd64/toolbox
chmod +x toolbox

Windows (Command Prompt)

Để cài đặt Toolbox dưới dạng tệp nhị phân trên Windows (Command Prompt):

:: xem trang phát hành để biết các phiên bản khác
set VERSION=1.15.0
curl -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v%VERSION%/windows/amd64/toolbox.exe"

Windows (PowerShell)

Để cài đặt Toolbox dưới dạng tệp nhị phân trên Windows (PowerShell):

# xem trang phát hành để biết các phiên bản khác
$VERSION = "1.15.0"
curl.exe -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/windows/amd64/toolbox.exe"

Windows ARM64 (Command Prompt)

Để cài đặt Toolbox dưới dạng tệp nhị phân trên Windows ARM64 (Command Prompt):

:: xem trang phát hành để biết các phiên bản khác
set VERSION=1.15.0
curl -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v%VERSION%/windows/arm64/toolbox.exe"

Windows ARM64 (PowerShell)

Để cài đặt Toolbox dưới dạng tệp nhị phân trên Windows ARM64 (PowerShell):

# xem trang phát hành để biết các phiên bản khác
$VERSION = "1.15.0"
curl.exe -o toolbox.exe "https://storage.googleapis.com/mcp-toolbox-for-databases/v$VERSION/windows/arm64/toolbox.exe"

# see releases page for other versions
export VERSION=1.15.0
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION

Để cài đặt Toolbox bằng Homebrew trên macOS hoặc Linux:

brew install mcp-toolbox

Để cài đặt từ mã nguồn, hãy đảm bảo bạn có phiên bản mới nhất của Go được cài đặt, sau đó chạy lệnh sau:

go install github.com/googleapis/mcp-toolbox@v1.15.0

# Install Gemini CLI
npm install -g @google/gemini-cli
# Install the extension
gemini extensions install https://github.com/gemini-cli-extensions/cloud-sql-postgres
# Run Gemini CLI
gemini

Tương tác với các công cụ tùy chỉnh của bạn bằng ngôn ngữ tự nhiên thông qua Gemini CLI.

# Install the extension
gemini extensions install https://github.com/gemini-cli-extensions/mcp-toolbox

Để chạy Toolbox từ tệp nhị phân:

./toolbox --config "tools.yaml"

ⓘ Lưu ý Toolbox bật tải lại động theo mặc định. Để tắt, hãy sử dụng cờ --disable-reload.

Để chạy máy chủ sau khi kéo hình ảnh container:

export VERSION=0.24.0 # Use the version you pulled
docker run -p 5000:5000 \
-v $(pwd)/tools.yaml:/app/tools.yaml \
us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION \
--config "/app/tools.yaml"

ⓘ Lưu ý Cờ -v gắn kết tools.yaml cục bộ của bạn vào container, và -p ánh xạ cổng 5000 của container tới cổng 5000 của máy chủ của bạn.

Để chạy máy chủ trực tiếp từ mã nguồn, hãy điều hướng đến thư mục gốc của dự án và chạy:

go run .

ⓘ Lưu ý Lệnh này chạy dự án từ mã nguồn và phù hợp hơn cho việc phát triển và kiểm thử. Nó không biên dịch tệp nhị phân vào $GOPATH của bạn. Nếu bạn muốn biên dịch tệp nhị phân thay vào đó, hãy tham khảo Tài liệu dành cho nhà phát triển.

Nếu bạn đã cài đặt Toolbox bằng Homebrew, thì binary toolbox có sẵn trong đường dẫn hệ thống của bạn. Bạn có thể khởi động server bằng cùng lệnh:

toolbox --config "tools.yaml"

Để chạy Toolbox trực tiếp mà không cần tải binary thủ công (yêu cầu Node.js):

npx @toolbox-sdk/server --config tools.yaml

# Run Gemini CLI
gemini

# List extensions
/extensions list
# List MCP servers
/mcp list

Core

1. Cài đặt Toolbox Core SDK:

   pip install toolbox-core
   

2. Nạp các công cụ:

   from toolbox_core import ToolboxClient
   
   # update the url to point to your server
   async with ToolboxClient("http://127.0.0.1:5000") as client:
   
       # these tools can be passed to your application!
       tools = await client.load_toolset("toolset_name")
   

Để xem hướng dẫn chi tiết hơn về cách sử dụng Toolbox Core SDK, hãy xem README của dự án.

LangChain / LangGraph

1. Cài đặt Toolbox LangChain SDK:

   pip install toolbox-langchain
   

2. Nạp các công cụ:

   from toolbox_langchain import ToolboxClient
   
   # update the url to point to your server
   async with ToolboxClient("http://127.0.0.1:5000") as client:
   
       # these tools can be passed to your application!
       tools = client.load_toolset()
   

   Để xem hướng dẫn chi tiết hơn về cách sử dụng Toolbox LangChain SDK, hãy xem README của dự án.

LlamaIndex

1. Cài đặt Toolbox Llamaindex SDK:

   pip install toolbox-llamaindex
   

2. Nạp các công cụ:

   from toolbox_llamaindex import ToolboxClient
   
   # update the url to point to your server
   async with ToolboxClient("http://127.0.0.1:5000") as client:
   
       # these tools can be passed to your application!
       tools = client.load_toolset()
   

   Để xem hướng dẫn chi tiết hơn về cách sử dụng Toolbox Llamaindex SDK, hãy xem README của dự án.

Core

1. Cài đặt Toolbox Core SDK:

   npm install @toolbox-sdk/core
   

2. Nạp các công cụ:

   import { ToolboxClient } from '@toolbox-sdk/core';
   
   // update the url to point to your server
   const URL = 'http://127.0.0.1:5000';
   let client = new ToolboxClient(URL);
   
   // these tools can be passed to your application!
   const tools = await client.loadToolset('toolsetName');
   

   Để xem hướng dẫn chi tiết hơn về cách sử dụng Toolbox Core SDK, hãy xem README của dự án.

LangChain / LangGraph

1. Cài đặt Toolbox Core SDK:

   npm install @toolbox-sdk/core
   

2. Nạp các công cụ:

   import { ToolboxClient } from '@toolbox-sdk/core';
   
   // update the url to point to your server
   const URL = 'http://127.0.0.1:5000';
   let client = new ToolboxClient(URL);
   
   // these tools can be passed to your application!
   const toolboxTools = await client.loadToolset('toolsetName');
   
   // Define the basics of the tool: name, description, schema and core logic
   const getTool = (toolboxTool) => tool(currTool, {
       name: toolboxTool.getName(),
       description: toolboxTool.getDescription(),
       schema: toolboxTool.getParamSchema()
   });
   
   // Use these tools in your Langchain/Langraph applications
   const tools = toolboxTools.map(getTool);
   

Genkit

1. Cài đặt Toolbox Core SDK:

   npm install @toolbox-sdk/core
   

2. Nạp các công cụ:

   import { ToolboxClient } from '@toolbox-sdk/core';
   import { genkit } from 'genkit';
   
   // Initialise genkit
   const ai = genkit({
       plugins: [
           googleAI({
               apiKey: process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY
           })
       ],
       model: googleAI.model('gemini-2.0-flash'),
   });
   
   // update the url to point to your server
   const URL = 'http://127.0.0.1:5000';
   let client = new ToolboxClient(URL);
   
   // these tools can be passed to your application!
   const toolboxTools = await client.loadToolset('toolsetName');
   
   // Define the basics of the tool: name, description, schema and core logic
   const getTool = (toolboxTool) => ai.defineTool({
       name: toolboxTool.getName(),
       description: toolboxTool.getDescription(),
       schema: toolboxTool.getParamSchema()
   }, toolboxTool)
   
   // Use these tools in your Genkit applications
   const tools = toolboxTools.map(getTool);
   

ADK

1. Cài đặt Toolbox ADK SDK:

   npm install @toolbox-sdk/adk
   

2. Nạp các công cụ:

   import { ToolboxClient } from '@toolbox-sdk/adk';
   
   // update the url to point to your server
   const URL = 'http://127.0.0.1:5000';
   let client = new ToolboxClient(URL);
   
   // these tools can be passed to your application!
   const tools = await client.loadToolset('toolsetName');
   

   Để xem hướng dẫn chi tiết hơn về cách sử dụng Toolbox ADK SDK, hãy xem README của dự án.

Core

1. Cài đặt Toolbox Go SDK:

   go get github.com/googleapis/mcp-toolbox-sdk-go
   

2. Nạp các công cụ:

   package main
   
   import (
     "github.com/googleapis/mcp-toolbox-sdk-go/core"
     "context"
   )
   
   func main() {
     // Make sure to add the error checks
     // update the url to point to your server
     URL := "http://127.0.0.1:5000";
     ctx := context.Background()
   
     client, err := core.NewToolboxClient(URL)
   
     // Framework agnostic tools
     tools, err := client.LoadToolset("toolsetName", ctx)
   }
   

   Để xem hướng dẫn chi tiết hơn về cách sử dụng Toolbox Go SDK, hãy xem README của dự án.

LangChain Go

1. Cài đặt Toolbox Go SDK:

   go get github.com/googleapis/mcp-toolbox-sdk-go
   

2. Nạp các công cụ:

   package main
   
   import (
     "context"
     "encoding/json"
   
     "github.com/googleapis/mcp-toolbox-sdk-go/core"
     "github.com/tmc/langchaingo/llms"
   )
   
   func main() {
     // Make sure to add the error checks
     // update the url to point to your server
     URL := "http://127.0.0.1:5000"
     ctx := context.Background()
   
     client, err := core.NewToolboxClient(URL)
   
     // Framework agnostic tool
     tool, err := client.LoadTool("toolName", ctx)
   
     // Fetch the tool's input schema
     inputschema, err := tool.InputSchema()
   
     var paramsSchema map[string]any
     _ = json.Unmarshal(inputschema, &paramsSchema)
   
     // Use this tool with LangChainGo
     langChainTool := llms.Tool{
       Type: "function",
       Function: &llms.FunctionDefinition{
         Name:        tool.Name(),
         Description: tool.Description(),
         Parameters:  paramsSchema,
       },
     }
   }
   
   

Genkit

1. Cài đặt Toolbox Go SDK:

   go get github.com/googleapis/mcp-toolbox-sdk-go
   

2. Nạp các công cụ:

   package main
   import (
     "context"
     "log"
   
     "github.com/firebase/genkit/go/genkit"
     "github.com/googleapis/mcp-toolbox-sdk-go/core"
     "github.com/googleapis/mcp-toolbox-sdk-go/tbgenkit"
   )
   
   func main() {
     // Make sure to add the error checks
     // Update the url to point to your server
     URL := "http://127.0.0.1:5000"
     ctx := context.Background()
     g := genkit.Init(ctx)
   
     client, err := core.NewToolboxClient(URL)
   
     // Framework agnostic tool
     tool, err := client.LoadTool("toolName", ctx)
   
     // Convert the tool using the tbgenkit package
     // Use this tool with Genkit Go
     genkitTool, err := tbgenkit.ToGenkitTool(tool, g)
     if err != nil {
       log.Fatalf("Failed to convert tool: %v\n", err)
     }
     log.Printf("Successfully converted tool: %s", genkitTool.Name())
   }
   

Go GenAI

1. Cài đặt Toolbox Go SDK:

   go get github.com/googleapis/mcp-toolbox-sdk-go
   

2. Nạp các công cụ:

   package main
   
   import (
     "context"
     "encoding/json"
   
     "github.com/googleapis/mcp-toolbox-sdk-go/core"
     "google.golang.org/genai"
   )
   
   func main() {
     // Make sure to add the error checks
     // Update the url to point to your server
     URL := "http://127.0.0.1:5000"
     ctx := context.Background()
   
     client, err := core.NewToolboxClient(URL)
   
     // Framework agnostic tool
     tool, err := client.LoadTool("toolName", ctx)
   
     // Fetch the tool's input schema
     inputschema, err := tool.InputSchema()
   
     var schema *genai.Schema
     _ = json.Unmarshal(inputschema, &schema)
   
     funcDeclaration := &genai.FunctionDeclaration{
       Name:        tool.Name(),
       Description: tool.Description(),
       Parameters:  schema,
     }
   
     // Use this tool with Go GenAI
     genAITool := &genai.Tool{
       FunctionDeclarations: []*genai.FunctionDeclaration{funcDeclaration},
     }
   }
   

OpenAI Go

1. Cài đặt Toolbox Go SDK:

   go get github.com/googleapis/mcp-toolbox-sdk-go
   

2. Nạp các công cụ:

   package main
   
   import (
     "context"
     "encoding/json"
   
     "github.com/googleapis/mcp-toolbox-sdk-go/core"
     openai "github.com/openai/openai-go"
   )
   
   func main() {
     // Make sure to add the error checks
     // Update the url to point to your server
     URL := "http://127.0.0.1:5000"
     ctx := context.Background()
   
     client, err := core.NewToolboxClient(URL)
   
     // Framework agnostic tool
     tool, err := client.LoadTool("toolName", ctx)
   
     // Fetch the tool's input schema
     inputschema, err := tool.InputSchema()
   
     var paramsSchema openai.FunctionParameters
     _ = json.Unmarshal(inputschema, &paramsSchema)
   
     // Use this tool with OpenAI Go
     openAITool := openai.ChatCompletionToolParam{
       Function: openai.FunctionDefinitionParam{
         Name:        tool.Name(),
         Description: openai.String(tool.Description()),
         Parameters:  paramsSchema,
       },
     }
   
   }
   

ADK Go

1. Cài đặt Toolbox Go SDK:

   go get github.com/googleapis/mcp-toolbox-sdk-go
   

2. Nạp các công cụ:

   package main
   
   import (
     "github.com/googleapis/mcp-toolbox-sdk-go/tbadk"
     "context"
   )
   
   func main() {
     // Make sure to add the error checks
     // Update the url to point to your server
     URL := "http://127.0.0.1:5000"
     ctx := context.Background()
     client, err := tbadk.NewToolboxClient(URL)
     if err != nil {
       return fmt.Sprintln("Could not start Toolbox Client", err)
     }
   
     // Use this tool with ADK Go
     tool, err := client.LoadTool("toolName", ctx)
     if err != nil {
       return fmt.Sprintln("Could not load Toolbox Tool", err)
     }
   }
   

   Để xem hướng dẫn chi tiết hơn về cách sử dụng Toolbox Go SDK, hãy xem README của dự án.