Официальный MCP-сервер YDB
YDB MCP
Официальный MCP-сервер YDB от разработчиков базы: SQL-запросы с параметрами, план выполнения, обзор директорий и основа для своих серверов
- 29 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- По умолчанию сервер только читает, но с флагом --ydb-allow-write выполняет произвольный SQL, включая изменение и удаление данных
- Аутентификация токеном или сервисным аккаунтом дает широкий доступ к базе, если не ограничить права ключа
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/ydb-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- По умолчанию сервер только читает, но с флагом --ydb-allow-write выполняет произвольный SQL, включая изменение и удаление данных
- Аутентификация токеном или сервисным аккаунтом дает широкий доступ к базе, если не ограничить права ключа
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту семь инструментов для распределенной базы данных YDB: выполнение SQL-запроса, выполнение параметризованного запроса с JSON-параметрами, получение плана выполнения для обычного и параметризованного запроса, просмотр содержимого директории, подробное описание пути (таблицы, директории) и статус соединения с базой. Поддерживаются анонимная аутентификация, логин и пароль, токен доступа и аутентификация через сервисный аккаунт Yandex Cloud с пакетом yandexcloud. Класс YDBMCPServer рассчитан на наследование: можно добавить свои инструменты поверх готового соединения и отключить общие инструменты, чтобы модель видела только нужный для бизнес-логики набор SQL-запросов вместо произвольного доступа к базе.
Для кого. Для разработчиков и дата-инженеров, которые работают с YDB и хотят выполнять запросы и смотреть схему базы через агента.
Подходит, если
- Нужен официальный, поддерживаемый разработчиками YDB MCP-сервер, а не сторонняя обертка
- Нужен план выполнения запроса перед тем, как гонять его на боевой базе
- Нужно ограничить агента фиксированным набором безопасных запросов через свой подкласс сервера
Не подходит, если
- Нужна защита от произвольного SQL при включенной записи: с флагом --ydb-allow-write сервер выполняет любой присланный запрос
- Работаете не с YDB, а с другой базой данных
Пример запроса к агенту
Покажи план выполнения этого запроса к YDB и список таблиц в директории /local/ordersMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Ограничения
По умолчанию сервер работает только на чтение: запросы идут в снимочных транзакциях YDB, а запись включается флагом --ydb-allow-write или переменной YDB_ALLOW_WRITE=true. С включенной записью сервер выполняет произвольный SQL, поэтому набор инструментов лучше сузить через наследование. Аутентификация через сервисный аккаунт Yandex Cloud требует дополнительный пакет yandexcloud. Для работы нужен доступный по grpc endpoint YDB, локальный или облачный.
Как отключить. Удалите блок ydb из конфигурации MCP клиента.
Частые вопросы
Можно ли ограничить агента только чтением?
Да, для этого нужно унаследоваться от YDBMCPServer, отключить общие инструменты и добавить свои с ограниченным набором запросов.
Какие способы аутентификации поддержаны?
Анонимный доступ, логин и пароль, токен доступа и сервисный аккаунт Yandex Cloud.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
YDB — все инструментыОфициальный MCP-сервер долгой памяти для агентов на базе YDB Serverless: mem0 извлекает факты, YDB хранит векторы
Демо MCP-подключения к YDB на примере заметок
Simple CLI Notes Application with YDB
Официальный пример YDB: docker compose поднимает базу YDB и MCP-сервер ydb-mcp, а Cursor через них выполняет SQL прямо из чата
Тулкит для локальных развертываний YDB
local-ydb-toolkit
Скилл и MCP-сервер для управления Docker-развертываниями local-ydb: узлы, схема, дамп и восстановление, локально или по SSH
Один MCP-сервер для SQLite, SQL Server, PostgreSQL и MySQL: агент читает и меняет данные, правит схему и выгружает CSV и JSON
Один бинарник MCP-сервера для MySQL, MariaDB, PostgreSQL и SQLite: запросы только на чтение по умолчанию и маскировка ПДн
MCP-сервер на Python для работы с MySQL: список таблиц, чтение данных, выполнение SQL и разбор схемы через контролируемый интерфейс
Коротко о README
README описывает YDB MCP как официальный сервер для работы с базами YDB из любого LLM, поддерживающего MCP. Показаны три способа установки и запуска (uvx, pipx, pip), примеры конфигурации для анонимного доступа, логина и пароля, токена доступа и сервисного аккаунта Yandex Cloud, список из семи инструментов и отдельный раздел про создание своих MCP-серверов на основе класса YDBMCPServer с отключением общих инструментов ради безопасности и специфики домена.