MCP Toolbox for Databases Server

Araç Kutusunu ikili dosya olarak kurmak için:

Linux (AMD64)

Araç Kutusunu Linux'ta (AMD64) ikili dosya olarak kurmak için:

# diğer sürümler için sürümler sayfasına bakın
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)

Araç Kutusunu macOS'ta (Apple Silicon) ikili dosya olarak kurmak için:

# diğer sürümler için sürümler sayfasına bakın
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)

Araç Kutusunu macOS'ta (Intel) ikili dosya olarak kurmak için:

# diğer sürümler için sürümler sayfasına bakın
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 (Komut İstemi)

Araç Kutusunu Windows'ta (Komut İstemi) ikili dosya olarak kurmak için:

:: diğer sürümler için sürümler sayfasına bakın
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)

Araç Kutusunu Windows'ta (PowerShell) ikili dosya olarak kurmak için:

# diğer sürümler için sürümler sayfasına bakın
$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 (Komut İstemi)

Araç Kutusunu Windows ARM64'te (Komut İstemi) ikili dosya olarak kurmak için:

:: diğer sürümler için sürümler sayfasına bakın
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)

Araç Kutusunu Windows ARM64'te (PowerShell) ikili dosya olarak kurmak için:

# diğer sürümler için sürümler sayfasına bakın
$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

Araç Kutusunu macOS veya Linux'ta Homebrew kullanarak kurmak için:

brew install mcp-toolbox

Kaynaktan kurmak için, Go'nun en son sürümünün yüklü olduğundan emin olun ve ardından aşağıdaki komutu çalıştırın:

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

Gemini CLI aracılığıyla doğal dil kullanarak özel araçlarınızla etkileşim kurun.

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

Araç Kutusunu ikili dosyadan çalıştırmak için:

./toolbox --config "tools.yaml"

ⓘ Not
Araç Kutusu varsayılan olarak dinamik yeniden yüklemeyi etkinleştirir. Devre dışı bırakmak için --disable-reload bayrağını kullanın.

Konteyner imajını çektikten sonra sunucuyu çalıştırmak için:

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"

ⓘ Not
-v bayrağı yerel tools.yaml dosyanızı konteynere bağlar ve -p, konteynerin 5000 portunu ana makinenizin 5000 portuna eşler.

Sunucuyu doğrudan kaynaktan çalıştırmak için, proje kök dizinine gidin ve şunu çalıştırın:

go run .

ⓘ Not
Bu komut projeyi kaynaktan çalıştırır ve geliştirme ve test için daha uygundur. $GOPATH dizininize bir ikili dosya derlemez. Bunun yerine bir ikili dosya derlemek istiyorsanız, Geliştirici Belgelerine bakın.

Araç Kutusunu Homebrew kullanarak kurduysanız, toolbox ikili dosyası sistem yolunuzda mevcuttur. Sunucuyu aynı komutla başlatabilirsiniz:

toolbox --config "tools.yaml"

# Run Gemini CLI
gemini

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

Core

1. Toolbox Core SDK'ı yükleyin:

   pip install toolbox-core
   

2. Araçları yükleyin:

   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")
   

Toolbox Core SDK'yı kullanma hakkında daha ayrıntılı talimatlar için projenin README dosyasına bakın.

LangChain / LangGraph

1. Toolbox LangChain SDK'ı yükleyin:

   pip install toolbox-langchain
   

2. Araçları yükleyin:

   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()
   

   Toolbox LangChain SDK'yı kullanma hakkında daha ayrıntılı talimatlar için projenin README dosyasına bakın.

LlamaIndex

1. Toolbox Llamaindex SDK'ı yükleyin:

   pip install toolbox-llamaindex
   

2. Araçları yükleyin:

   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()
   

   Toolbox Llamaindex SDK'yı kullanma hakkında daha ayrıntılı talimatlar için projenin README dosyasına bakın.

Core

1. Toolbox Core SDK'ı yükleyin:

   npm install @toolbox-sdk/core
   

2. Araçları yükleyin:

   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');
   

   Toolbox Core SDK'yı kullanma hakkında daha ayrıntılı talimatlar için projenin README dosyasına bakın.

LangChain / LangGraph

1. Toolbox Core SDK'ı yükleyin:

   npm install @toolbox-sdk/core
   

2. Araçları yükleyin:

   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. Toolbox Core SDK'ı yükleyin:

   npm install @toolbox-sdk/core
   

2. Araçları yükleyin:

   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. Toolbox ADK SDK'ı yükleyin:

   npm install @toolbox-sdk/adk
   

2. Araçları yükleyin:

   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');
   

   Toolbox ADK SDK'yı kullanma hakkında daha ayrıntılı talimatlar için projenin README dosyasına bakın.

Core

1. Toolbox Go SDK'ı yükleyin:

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

2. Araçları yükleyin:

   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)
   }
   

   Toolbox Go SDK'yı kullanma hakkında daha ayrıntılı talimatlar için projenin README dosyasına bakın.

LangChain Go

1. Toolbox Go SDK'ı yükleyin:

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

2. Araçları yükleyin:

   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. Toolbox Go SDK'ı yükleyin:

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

2. Araçları yükleyin:

   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. Toolbox Go SDK'ı yükleyin:

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

2. Araçları yükleyin:

   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. Toolbox Go SDK'ı yükleyin:

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

2. Araçları yükleyin:

   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. Toolbox Go SDK'ı yükleyin:

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

2. Araçları yükleyin:

   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)
     }
   }
   

   Toolbox Go SDK'yı kullanma hakkında daha ayrıntılı talimatlar için projenin README dosyasına bakın.