MCP Toolbox for Databases

Упростите интеграцию GenAI-инструментов с базами данных с помощью Genai Toolbox. Пул соединений, аутентификация, OpenTelemetry, централизованное управление и многое другое!

Data Science и ML Инструменты разработчика Базы данных ★ 590 GitHub (590 ★)

MCP Toolbox for Databases — это сервер с открытым исходным кодом, который упрощает разработку, развертывание и управление инструментами GenAI для доступа к данным в базах данных. Он предоставляет централизованное место для хранения и обновления инструментов, позволяя делиться ими между агентами и приложениями без повторного развертывания. Благодаря таким функциям, как пул соединений, встроенная аутентификация и сквозная наблюдаемость, Toolbox повышает производительность, безопасность и удобство использования ваших взаимодействий с базами данных на базе GenAI.

Ключевые особенности

01Предоставляет пул соединений и аутентификацию.

02Обеспечивает сквозную наблюдаемость с поддержкой OpenTelemetry.

03590 звезд на GitHub

04Упрощает интеграцию инструментов GenAI с базами данных.

05Поддерживает различные клиентские SDK, включая LangChain и LlamaIndex.

06Обеспечивает централизованное управление и совместное использование инструментов.

Варианты использования

01Создание агентов на базе GenAI, которые могут получать доступ к данным в базах данных и манипулировать ими.

02Разработка безопасных и масштабируемых инструментов GenAI для корпоративного использования.

03Интеграция доступа к базам данных в существующие рабочие процессы GenAI.

MCP Toolbox for Databases

Note

MCP Toolbox for Databases is currently in beta, and may see breaking changes until the first stable release (v1.0).

MCP Toolbox for Databases is an open source MCP server for databases It was designed with enterprise-grade and production-quality in mind. It enables you to develop tools easier, faster, and more securely by handling the complexities such as connection pooling, authentication, and more.

This README provides a brief overview. For comprehensive details, see the full documentation.

Note

This product was originally named “Gen AI Toolbox for Databases” as its initial development predated MCP, but was renamed to align with recently added MCP compatibility.

Why Toolbox?
General Architecture
Getting Started
Configuration
- Sources
- Tools
- Toolsets
Versioning
Contributing

Why Toolbox?

Toolbox helps you build Gen AI tools that let your agents access data in your database. Toolbox provides:

Simplified development: Integrate tools to your agent in less than 10 lines of code, reuse tools between multiple agents or frameworks, and deploy new versions of tools more easily.
Better performance: Best practices such as connection pooling, authentication, and more.
Enhanced security: Integrated auth for more secure access to your data
End-to-end observability: Out of the box metrics and tracing with built-in support for OpenTelemetry.

General Architecture

Toolbox sits between your application's orchestration framework and your database, providing a control plane that is used to modify, distribute, or invoke tools. It simplifies the management of your tools by providing you with a centralized location to store and update tools, allowing you to share tools between agents and applications and update those tools without necessarily redeploying your application.

Getting Started

Installing the server

For the latest version, check the releases page and use the following instructions for your OS and CPU architecture.

Binary

To install Toolbox as a binary:

# see releases page for other versions
export VERSION=0.3.0
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
chmod +x toolbox

Container image

You can also install Toolbox as a container:

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

Compile from source

To install from source, ensure you have the latest version of Go installed, and then run the following command:

go install github.com/googleapis/genai-toolbox@v0.3.0

Running the server

Configure a tools.yaml to define your tools, and then execute toolbox to start the server:

./toolbox --tools_file "tools.yaml"

You can use toolbox help for a full list of flags! To stop the server, send a terminate signal (ctrl+c on most platforms).

For more detailed documentation on deploying to different environments, check out the resources in the How-to section

Integrating your application

Once your server is up and running, you can load the tools into your application. See below the list of Client SDKs for using various frameworks:

Core

Install Toolbox Core SDK:
```
pip install toolbox-core
```

Load tools:

from toolbox_core import ToolboxClient

# update the url to point to your server
client = ToolboxClient("http://127.0.0.1:5000")

# these tools can be passed to your application! 
tools = await client.load_toolset("toolset_name")

For more detailed instructions on using the Toolbox Core SDK, see the project's README.

LangChain / LangGraph

Install Toolbox LangChain SDK:
```
pip install toolbox-langchain
```

Load tools:

from toolbox_langchain import ToolboxClient

# update the url to point to your server
client = ToolboxClient("http://127.0.0.1:5000")

# these tools can be passed to your application! 
tools = client.load_toolset()

For more detailed instructions on using the Toolbox LangChain SDK, see the project's README.

LlamaIndex

Install Toolbox Llamaindex SDK:
```
pip install toolbox-llamaindex
```

Load tools:

from toolbox_llamaindex import ToolboxClient

# update the url to point to your server
client = ToolboxClient("http://127.0.0.1:5000")

# these tools can be passed to your application! 
tools = client.load_toolset()

For more detailed instructions on using the Toolbox Llamaindex SDK, see the project's README.

Configuration

The primary way to configure Toolbox is through the tools.yaml file. If you have multiple files, you can tell toolbox which to load with the --tools_file tools.yaml flag.

You can find more detailed reference documentation to all resource types in the Resources.

Sources

The sources section of your tools.yaml defines what data sources your Toolbox should have access to. Most tools will have at least one source to execute against.

sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: toolbox_db
    user: toolbox_user
    password: my-password

For more details on configuring different types of sources, see the Sources.

Tools

The tools section of a tools.yaml define the actions an agent can take: what kind of tool it is, which source(s) it affects, what parameters it uses, etc.

tools:
  search-hotels-by-name:
    kind: postgres-sql
    source: my-pg-source
    description: Search for hotels based on name.
    parameters:
      - name: name
        type: string
        description: The name of the hotel.
    statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';

For more details on configuring different types of tools, see the Tools.

Toolsets

The toolsets section of your tools.yaml allows you to define groups of tools that you want to be able to load together. This can be useful for defining different groups based on agent or application.

toolsets:
    my_first_toolset:
        - my_first_tool
        - my_second_tool
    my_second_toolset:
        - my_second_tool
        - my_third_tool

You can load toolsets by name:

# This will load all tools
all_tools = client.load_toolset()

# This will only load the tools listed in 'my_second_toolset'
my_second_toolset = client.load_toolset("my_second_toolset")

Versioning

This project uses semantic versioning, including a MAJOR.MINOR.PATCH version number that increments with:

MAJOR version when we make incompatible API changes
MINOR version when we add functionality in a backward compatible manner
PATCH version when we make backward compatible bug fixes

The public API that this applies to is the CLI associated with Toolbox, the interactions with official SDKs, and the definitions in the tools.yaml file.

Contributing

Contributions are welcome. Please, see the CONTRIBUTING to get started.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See Contributor Code of Conduct for more information.

MCP Toolbox for Databases

MCP Toolbox for Databases — это open-source MCP-сервер для работы с базами данных, спроектированный для корпоративного использования. Он берёт на себя сложности управления подключениями, аутентификации и других рутинных задач, позволяя быстрее и безопаснее разрабатывать инструменты для агентов ИИ.

Важно: Проект находится на стадии бета-тестирования и до первого стабильного релиза (v1.0) возможны обратно несовместимые изменения.

Исходное название продукта — «Gen AI Toolbox for Databases»; он был переименован после добавления поддержки MCP.

Зачем нужен Toolbox?

Toolbox упрощает создание Gen AI-инструментов для доступа агентов к данным в вашей базе данных. Ключевые преимущества:

Простота разработки — интегрируйте инструменты в агента менее чем за 10 строк кода, переиспользуйте их между разными агентами и фреймворками, легко развёртывайте новые версии.
Производительность — реализованы best practices: пул соединений, аутентификация и т.д.
Безопасность — встроенная аутентификация для защищённого доступа к данным.
Наблюдаемость — метрики и трассировка «из коробки» с поддержкой OpenTelemetry.

Общая архитектура

Toolbox располагается между оркестратором вашего приложения и базой данных, предоставляя управляющую плоскость (control plane) для модификации, распространения и вызова инструментов. Это централизованное хранилище инструментов упрощает их обновление и переиспользование между агентами и приложениями без необходимости переразвёртывать приложение.

Быстрый старт

Установка сервера

Актуальную версию ищите на странице релизов.

Бинарный файл:

export VERSION=0.3.0
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
chmod +x toolbox

Docker:

export VERSION=0.3.0
docker pull us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:$VERSION

Сборка из исходников (требуется Go):

go install github.com/googleapis/genai-toolbox@v0.3.0

Запуск сервера

Создайте файл конфигурации tools.yaml (см. раздел Конфигурация) и запустите сервер:

./toolbox --tools_file "tools.yaml"

Полный список флагов — ./toolbox help. Остановка — Ctrl+C.

Больше примеров развёртывания — в How-to разделе документации.

Интеграция с приложением

После запуска сервера загрузите инструменты через один из SDK. Ниже примеры для разных фреймворков.

Core SDK:

pip install toolbox-core
from toolbox_core import ToolboxClient

client = ToolboxClient("http://127.0.0.1:5000")
tools = await client.load_toolset("toolset_name")

Документация Toolbox Core SDK

LangChain / LangGraph:

pip install toolbox-langchain
from toolbox_langchain import ToolboxClient

client = ToolboxClient("http://127.0.0.1:5000")
tools = client.load_toolset()

Документация Toolbox LangChain SDK

LlamaIndex:

pip install toolbox-llamaindex
from toolbox_llamaindex import ToolboxClient

client = ToolboxClient("http://127.0.0.1:5000")
tools = client.load_toolset()

Документация Toolbox Llamaindex SDK

Конфигурация

Основной способ настройки — YAML-файл tools.yaml. Можно указать его флагом --tools_file. Полную спецификацию ресурсов см. в документации.

Sources (источники данных)

Определяет, к каким базам данных будет подключаться Toolbox. Пример для PostgreSQL:

sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: toolbox_db
    user: toolbox_user
    password: my-password

Подробнее о настройке источников

Tools (инструменты)

Определяют действия, которые может выполнять агент: тип инструмента, источник, параметры и SQL-запрос. Пример:

tools:
  search-hotels-by-name:
    kind: postgres-sql
    source: my-pg-source
    description: Search for hotels based on name.
    parameters:
      - name: name
        type: string
        description: The name of the hotel.
    statement: SELECT * FROM hotels WHERE name ILIKE '%' || $1 || '%';

Подробнее о настройке инструментов

Toolsets (наборы инструментов)

Группируют инструменты для совместной загрузки. Удобно для разделения по агентам или приложениям.

toolsets:
  my_first_toolset:
    - my_first_tool
    - my_second_tool
  my_second_toolset:
    - my_second_tool
    - my_third_tool

Загрузка по имени:

all_tools = client.load_toolset()  # все инструменты
my_second_toolset = client.load_toolset("my_second_toolset")

Versioning

Проект следует семантическому версионированию. Публичный API включает:

CLI Toolbox
Взаимодействие с официальными SDK
Определения в файле tools.yaml

Участие в разработке

Приветствуются любые вклады. Начните с ознакомления с CONTRIBUTING.

Проект использует Contributor Code of Conduct.

Источник: https://mcpmarket.com/server/genai-toolbox

MCP Toolbox for Databases

Ключевые особенности

Варианты использования

MCP Toolbox for Databases

Table of Contents

Why Toolbox?

General Architecture

Getting Started

Installing the server

Running the server

Integrating your application

Configuration

Sources

Tools

Toolsets

Versioning

Contributing

MCP Toolbox for Databases

Оглавление

Зачем нужен Toolbox?

Общая архитектура

Быстрый старт

Установка сервера

Запуск сервера

Интеграция с приложением

Конфигурация

Sources (источники данных)

Tools (инструменты)

Toolsets (наборы инструментов)

Versioning

Участие в разработке

Что такое MCP Toolbox for Databases?

Какие клиентские SDK поддерживает Genai Toolbox?

Как начать работу с Genai Toolbox?

Каковы ключевые преимущества использования MCP Toolbox for Databases?

Комментарии