MCP Toolbox for Databases Server

Để 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.4.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.4.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.4.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.4.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.4.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.4.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.4.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.4.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ài đặt, và sau đó chạy lệnh sau:

go install github.com/googleapis/[email protected]

# 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 kích hoạ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 tải ả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, đ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 phát triển và thử nghiệm. 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 thế, hãy tham khảo Tài liệu Nhà phát triển.

Nếu bạn đã cài đặt Toolbox bằng Homebrew, tệp nhị phân toolbox có sẵn trong đường dẫn hệ thống của bạn. Bạn có thể khởi động máy chủ với cùng một lệnh:

toolbox --config "tools.yaml"

Để chạy Toolbox trực tiếp mà không cần tải xuống tệp nhị phân 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

Cốt lõi

1. Cài đặt SDK Cốt lõi Toolbox:

   pip install toolbox-core
   

2. Tải 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")
   

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

LangChain / LangGraph

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

   pip install toolbox-langchain
   

2. Tải 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()
   

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

LlamaIndex

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

   pip install toolbox-llamaindex
   

2. Tải 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()
   

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

Cốt lõi

1. Cài đặt SDK Cốt lõi Toolbox:

   npm install @toolbox-sdk/core
   

2. Tải 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');
   

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

LangChain / LangGraph

1. Cài đặt SDK Cốt lõi Toolbox:

   npm install @toolbox-sdk/core
   

2. Tải 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 SDK Cốt lõi Toolbox:

   npm install @toolbox-sdk/core
   

2. Tải 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 SDK ADK Toolbox:

   npm install @toolbox-sdk/adk
   

2. Tải 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');
   

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

Cốt lõi

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

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

2. Tải 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)
   }
   

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

LangChain Go

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

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

2. Tải 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 SDK Go Toolbox:

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

2. Tải 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 SDK Go Toolbox:

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

2. Tải 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 SDK Go Toolbox:

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

2. Tải 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 SDK Go Toolbox:

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

2. Tải 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)
     }
   }
   

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