MCP Toolbox for Databases
Открытый MCP-сервер Google для баз данных: готовые инструменты для Postgres, MySQL, BigQuery, Spanner и других, плюс свои инструменты в tools.yaml
- 16 756 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Может выполнять произвольный SQL в подключенной базе
- Работает с учетными данными баз данных
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-toolbox-for-databasesОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Может выполнять произвольный SQL в подключенной базе
- Работает с учетными данными баз данных
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Toolbox это один сервер на Go, который запускается из бинарника, контейнера, Homebrew или через npx @toolbox-sdk/server. С флагом --prebuilt=postgres агент получает типовые инструменты выбранной СУБД, а запись вида --prebuilt=postgres/data оставляет только SQL-часть. Вторая роль описывается в файле tools.yaml: блоки kind source задают подключение, tool задают именованный запрос с параметрами и шаблоном SQL, toolset объединяет инструменты в группы, а prompt и resource добавляют подсказки и файлы. Клиент подключается по HTTP к адресу 127.0.0.1:5000/mcp, а для одного набора адрес получает суффикс с именем toolset. Флаг --ui открывает проверочный интерфейс, --telemetry-otlp отправляет трассы и метрики OpenTelemetry, а команда skills-generate превращает набор в Agent Skill. Конфиг перечитывается на лету, отключить это можно флагом --disable-reload.
Для кого. Для разработчиков и аналитиков, которым нужен доступ агента к базам данных, в том числе в Google Cloud.
Подходит, если
- Вы пишете запросы к PostgreSQL в Claude Code и хотите, чтобы агент сначала увидел таблицы через list_tables, а потом выполнил execute_sql, без собственного кода
- В продакшн-агенте у менеджеров нельзя выдавать произвольный SQL: в tools.yaml вы описываете search-hotels-by-name как параметризованный запрос, и модель вызывает только его
- Данные лежат в BigQuery, Spanner, AlloyDB или Cloud SQL, и нужен сервер от того же вендора, что и база
- Один сервер должен обслуживать и MCP-клиент в IDE, и приложение на LangChain или LlamaIndex через клиентские SDK
- Нужны трассы и метрики обращений агента к базе: сервер экспортирует OpenTelemetry на любой OTLP-приемник
Не подходит, если
- База только PostgreSQL, и нужен разбор планов и подбор индексов: возьмите Postgres MCP Pro, там для этого отдельные инструменты
- Нужно управлять проектами и ветками облачного Postgres: смотрите Neon MCP Server или Supabase MCP Server
- Нужен самый простой запуск без YAML и описания источников: для одной базы проще специализированный MCP-сервер от вендора вашей СУБД
- Нужна работа с файлами и API, а не с базой: Toolbox для этого не предназначен
Пример запроса к агенту
Через toolbox-postgres покажи таблицы базы shop, затем напиши запрос, который считает заказы из таблицы orders по месяцам за 2025 год, и выполни егоMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Доступ: расширенный для prebuilt-инструментов и узкий для самописных в tools.yaml. Сервер подключается к базе с учетными данными из переменных окружения или блока source и выполняет то, что разрешают инструменты. Готовые инструменты вроде execute_sql позволяют любой SQL с правами учетной записи, поэтому для продакшна нужна запись только на чтение или собственные запросы. Набор переменных зависит от СУБД и описан в справочнике prebuilt-конфигураций. Запуск через npx авторы считают удобным, но менее надежным, чем бинарник или контейнер. Версии идут по семантическому версионированию, а изменения в готовых наборах могут выходить в минорных релизах. Лицензия Apache 2.0.
Как отключить. Удалите блок toolbox из конфигурации MCP клиента и остановите процесс toolbox или контейнер.
Частые вопросы
Раньше проект назывался иначе?
Да, это бывший Gen AI Toolbox for Databases, репозиторий googleapis/genai-toolbox переименован в mcp-toolbox. Название поменяли, когда проект выровняли под протокол MCP. Локальный remote можно обновить командой git remote set-url origin с новым адресом.
Какие базы поддерживаются?
Облачные базы Google: AlloyDB, BigQuery, Cloud SQL, Spanner, Firestore. Из остальных названы PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, MongoDB, Redis, Elasticsearch, CockroachDB, ClickHouse, Couchbase, Neo4j, Snowflake и Trino. Полный список в справочнике prebuilt-конфигураций.
Как подключить к Claude Code или Cursor?
Добавьте в mcp.json сервер с командой npx и аргументами -y, @toolbox-sdk/server, --prebuilt=postgres и --stdio, затем задайте переменные окружения для подключения. Либо запустите toolbox --config tools.yaml и укажите в клиенте тип http и адрес 127.0.0.1:5000/mcp.
Как проверить, что инструменты загрузились?
Запустите сервер с флагом --ui и попробуйте вызвать инструмент в интерфейсе. В Gemini CLI команды /mcp list и /extensions list покажут подключенные серверы и расширения.
Чем Toolbox отличается от Postgres MCP Pro?
Toolbox охватывает много СУБД и позволяет заранее описывать разрешенные запросы в tools.yaml. Postgres MCP Pro работает только с PostgreSQL и добавляет диагностику, план запросов и подбор индексов.
Как ограничить агента только нужными запросами?
Опишите в tools.yaml блоки tool с параметрами и фиксированным SQL, соберите их в toolset и подключайте клиента по адресу с именем набора. Тогда модель увидит только эти инструменты и не получит execute_sql.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыpgEdge Postgres MCP
pgEdge Postgres MCP Server
Postgres MCP на Go с запросами в режиме чтения, планами EXPLAIN, поиском по смыслу, несколькими базами, чат-клиентом и веб-интерфейсом
MCP-сервер на Go: агент задает вопросы базе PostgreSQL обычными словами и получает результат запроса
Postgres MCP (Microsoft)
Postgres MCP Server (Microsoft)
Postgres MCP от Microsoft: профили подключения с паролями в связке ключей ОС, вход через Entra ID для Azure, запросы, схема, CSV и метрики сервера
MCP-сервер и REST API для баз данных на Go: PostgreSQL, MySQL, ClickHouse, Snowflake, BigQuery и других, с маскировкой персональных данных и кэшем
MCP-сервер на Python для работы с MySQL: список таблиц, чтение данных, выполнение SQL и разбор схемы через контролируемый интерфейс
MCP-сервер для PostgreSQL с несколькими базами сразу, описаниями таблиц из каталога, подсказками по PostGIS и pgvector и планами запросов
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP Toolbox for Databases (эта запись) | да | не нужна | 16 756 | |
| Anyquery | нет | ключ необязателен | 1 787 | SQL-движок на SQLite с плагинами для приложений |
| CentralMind Gateway | нет | ключ необязателен | 549 | MCP-сервер и REST API для баз данных на Go |
Коротко о README
README объясняет два режима работы: готовые инструменты и фреймворк своих инструментов. Приведен пример конфигурации MCP для Postgres, разобраны разделы tools.yaml. Описана установка бинарником, контейнером, через Homebrew, go install и расширения Gemini CLI, а также подключение SDK. Лицензия Apache-2.0.