Claude Info
Базы данных

MCP Toolbox для баз данных

googleapis/mcp-toolbox

MCP Toolbox for Databases — открытый MCP-сервер, соединяющий AI-агентов, IDE и приложения с корпоративными БД. Поддерживает BigQuery, PostgreSQL, MySQL, Spanner, AlloyDB, ClickHouse, CockroachDB и другие. Включает готовые инструменты для мгновенного доступа к данным и фреймворк для создания кастомных безопасных инструментов.

Подключение

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

README

logo

MCP Toolbox для баз данных

Go Report Card License: Apache 2.0 Docs Discord Medium

Python SDK JS/TS SDK Go SDK Java SDK

MCP Toolbox for Databases — это открытый MCP-сервер, который подключает ваших AI-агентов, IDE и приложения напрямую к корпоративным базам данных.

Сервер решает две задачи:

  1. Готовый MCP-сервер (время сборки): Мгновенно подключите Gemini CLI, Google Antigravity, Claude Code, Codex или другие MCP-клиенты к вашим базам данных с помощью готовых универсальных инструментов. Работайте с данными на естественном языке, исследуйте схемы и генерируйте код без написания шаблонного кода.
  2. Фреймворк для кастомных инструментов (время выполнения): Надёжный фреймворк для создания специализированных, высокозащищённых AI-инструментов для продакшн-агентов. Безопасно и просто определяйте структурированные запросы, семантический поиск и возможности NL2SQL.

Этот README содержит краткий обзор. Подробная документация доступна на mcp-toolbox.dev.

[!IMPORTANT] Обновление названия репозитория: Репозиторий genai-toolbox официально переименован в mcp-toolbox. Чтобы обновить локальное окружение, выполните: git remote set-url origin https://github.com/googleapis/mcp-toolbox.git

[!NOTE] Изначально решение называлось «Gen AI Toolbox for Databases» (github.com/googleapis/genai-toolbox), поскольку его разработка началась до появления MCP. Переименование выполнено для соответствия стандарту MCP.

Содержание

Почему MCP Toolbox?

  • Готовый доступ к базам данных: Предустановленные универсальные инструменты для мгновенного исследования данных (например, list_tables, execute_sql) прямо из IDE или CLI.
  • Фреймворк кастомных инструментов: Создавайте продакшн-готовые инструменты с собственной предопределённой логикой, обеспечивая безопасность через ограниченный доступ, структурированные запросы и семантический поиск.
  • Упрощённая разработка: Интегрируйте инструменты в Agent Development Kit (ADK), LangChain, LlamaIndex или собственных агентов менее чем в 10 строках кода.
  • Высокая производительность: Управление пулом соединений, встроенная аутентификация (IAM) и сквозная наблюдаемость (OpenTelemetry) из коробки.
  • Повышенная безопасность: Встроенная аутентификация для более защищённого доступа к данным.
  • Сквозная наблюдаемость: Метрики и трассировка из коробки с поддержкой OpenTelemetry.

Быстрый старт: готовые инструменты

Прекратите переключаться между контекстами и превратите AI-ассистента в настоящего соразработчика. Подключив IDE к базам данных через MCP Toolbox, вы сможете запрашивать данные на естественном языке, автоматизировать обнаружение и управление схемами, а также генерировать код с учётом структуры БД.

Toolbox можно использовать в любом MCP-совместимом IDE или клиенте (например, Gemini CLI, Google Antigravity, Claude Code, Codex и др.), настроив MCP-сервер.

Готовые инструменты также доступны через Google Antigravity MCP Store — установка в один клик.

  1. Добавьте следующее в конфигурационный файл MCP вашего клиента (обычно mcp.json или claude_desktop_config.json):

    json
    {
  "mcpServers": {
    "toolbox-postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@toolbox-sdk/server",
        "--prebuilt=postgres"
      ]
    }
  }
}

  2. Задайте необходимые переменные окружения для подключения — см. справочник по готовым конфигурациям.

При запуске Toolbox с флагом --prebuilt=<database> вы мгновенно получаете доступ к стандартным инструментам для работы с этой базой данных.

Поддерживаемые базы данных:

  • Google Cloud: AlloyDB, BigQuery, Cloud SQL (PostgreSQL, MySQL, SQL Server), Spanner, Firestore, Knowledge Catalog
  • Реляционные БД: PostgreSQL, MySQL, SQL Server, SQLite, CockroachDB
  • Аналитические БД: ClickHouse, Redshift, Snowflake
  • И другие — полный список в документации.

Быстрый старт: кастомные инструменты

Для продакшн-агентов определите собственные инструменты в файле конфигурации tools.yaml. Это позволяет точно контролировать, какие запросы выполняются и как обрабатываются данные.

Пример tools.yaml:

yaml
sources:
  my-pg-source:
    kind: postgres
    host: 127.0.0.1
    port: 5432
    database: my_database
    user: my_user
    password: my_password

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 LIKE '%' || $1 || '%';

Установка и запуск сервера Toolbox

Скачайте последнюю версию бинарного файла для вашей платформы со страницы релизов и запустите сервер:

sh
# Пример для Linux (amd64)
export OS="linux"
export ARCH="amd64"
export VERSION=0.9.0
curl -O https://storage.googleapis.com/mcp-toolbox/v$VERSION/toolbox_${OS}_${ARCH}
chmod +x toolbox_${OS}_${ARCH}
./toolbox_${OS}_${ARCH} --tools-file "tools.yaml"

Подробные инструкции по установке для всех платформ — в документации.

Подключение к Toolbox

MCP-клиент

Добавьте Toolbox как MCP-сервер в конфигурацию вашего клиента:

json
{
  "mcpServers": {
    "toolbox": {
      "url": "http://127.0.0.1:5000/mcp"
    }
  }
}

Toolbox SDK: интеграция с приложением

Используйте один из официальных SDK для интеграции Toolbox в ваше приложение:

Python:

py
from toolbox_core import ToolboxClient
client = ToolboxClient("http://127.0.0.1:5000")
tools = await client.load_toolset("my-toolset")

TypeScript:

ts
import { ToolboxClient } from '@toolbox-sdk/core';
const client = new ToolboxClient('http://127.0.0.1:5000');
const tools = await client.loadToolset('my-toolset');

Доступные SDK:

Дополнительные возможности

  • Аутентификация: Встроенная поддержка IAM и других механизмов аутентификации.
  • OpenTelemetry: Сквозная трассировка и метрики из коробки.
  • Пул соединений: Автоматическое управление соединениями с БД.
  • Семантический поиск: Поддержка векторного поиска для AI-приложений.
  • NL2SQL: Преобразование запросов на естественном языке в SQL.

Подробнее — в полной документации.

Версионирование

Проект следует семантическому версионированию. Список изменений доступен на странице релизов.

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

Мы приветствуем вклад сообщества! Ознакомьтесь с руководством по участию перед отправкой pull request.

Сообщество

  • Discord — общение и поддержка
  • Medium — статьи и обновления
  • GitHub Issues — сообщения об ошибках и запросы функций