Тулкит для локальных развертываний YDB
local-ydb-toolkit
Скилл и MCP-сервер для управления Docker-развертываниями local-ydb: узлы, схема, дамп и восстановление, локально или по SSH
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Может запускать и останавливать Docker-контейнеры и узлы YDB на хосте
- Изменяющие инструменты применяют DDL и восстановление данных после подтверждения confirm: true
Установка
Ручная установка
codex plugin marketplace add astandrik/local-ydb-toolkit --ref main && codex plugin add local-ydb-toolkit@local-ydb-toolkitОсновной путь установки для Codex, требуется новая сессия после установки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Тулкит дополняет официальный сервер ydb-platform/ydb-mcp, который дает общие инструменты уровня базы данных вроде произвольных SQL-запросов. Этот проект решает другую задачу: эксплуатацию самого Docker-развертывания local-ydb, локально или через SSH. Инструменты проверяют предпосылки хоста, поднимают root и тенантные базы, управляют жизненным циклом динамических узлов, проверяют GraphShard, генерируют, валидируют и применяют DDL таблиц, укрепляют авторизацию, работают с хранилищем и делают дамп и восстановление. Инструмент local_ydb_sql нарочно уже общего SQL-инструмента официального сервера: выполняет только управляемый YQL против выбранного локального профиля. Изменяющие инструменты сначала показывают план и требуют confirm: true перед выполнением. Публикуется как npm-пакет @astandrik/local-ydb-mcp и как Agent Plugin для Codex, Claude Code и Gemini CLI.
Для кого. Для разработчиков, которые поднимают локальные или SSH-развертывания YDB для разработки и CI и хотят управлять их жизненным циклом через агента.
Подходит, если
- Нужно поднять или проверить Docker-развертывание local-ydb перед разработкой
- Нужно сгенерировать и применить DDL таблиц для локального YDB
- Нужен эфемерный тенант YDB в GitHub Actions через связанный экшен setup-local-ydb
Не подходит, если
- Нужен общий доступ к продуктивной или облачной базе YDB с произвольными SQL-запросами: для этого официальный ydb-platform/ydb-mcp подходит лучше
- Нельзя разрешить агенту запускать Docker-команды на хосте: тулкит именно это и делает
Пример запроса к агенту
Проверь предпосылки хоста для local-ydb, подними тенантную базу и сделай дамп схемы перед миграциейОграничения
MCP-сервер требует Node.js 20.19 или новее и npx, первый запуск обращается к реестру npm за пакетом @astandrik/local-ydb-mcp. Публикация в каталоге плагинов Claude Community и в галерее расширений Gemini еще не завершена на момент проверки, прямая установка из репозитория работает уже сейчас. Внешние оценки вроде VerifyMCP и glama README прямо называет снимками каталогов, а не подтверждением безопасности.
Как отключить. Удалите плагин командой codex plugin remove или сотри конфигурацию .mcp.json и каталог skills/local-ydb.
Проверка безопасности
- Может запускать и останавливать Docker-контейнеры и узлы YDB на хосте
- Изменяющие инструменты применяют DDL и восстановление данных после подтверждения confirm: true
Коротко о README
README на английском отдельным разделом Relationship to ydb/ydb-mcp разграничивает зоны ответственности с официальным сервером, описывает три поверхности установки: Agent Plugin для Codex, плагин Claude Code и расширение Gemini CLI, а также экшен setup-local-ydb для GitHub Actions, и подробно объясняет требования к абсолютному пути конфигурации и правило подтверждения для изменяющих инструментов.
Частые вопросы
Чем отличается от официального ydb-platform/ydb-mcp?
Официальный сервер дает общие инструменты уровня базы вроде произвольных SQL-запросов к существующему эндпоинту YDB, а этот тулкит управляет самим Docker-развертыванием local-ydb: узлами, DDL, дампом и восстановлением.
Инструменты меняют данные без подтверждения?
Нет, изменяющие инструменты сначала показывают план операции и выполняются только после явного confirm: true.
Похожие
MCP-сервер, встроенный в агент Netdata: метрики, логи, алерты и живые данные о процессах, сервисах и контейнерах для AI-ассистента
Официальный MCP-сервер GitHub: код, issues, пул-реквесты, Actions и алерты безопасности прямо из агента
Agent Skills для продуктов Google
Agent Skills for Google products and technologies
Официальная коллекция скиллов Google для работы с Google Cloud, BigQuery, GKE, рекламой и аналитикой из агента
MCP-серверы для AWS
Open source MCP servers for AWS
Официальный набор MCP-серверов AWS: документация, IaC, контейнеры, serverless, базы данных, стоимость и мониторинг