Тулкит для локальных развертываний YDB
local-ydb-toolkit
Скилл и MCP-сервер для управления Docker-развертываниями local-ydb: узлы, схема, дамп и восстановление, локально или по SSH
- 5 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Может запускать и останавливать 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, требуется новая сессия после установки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Может запускать и останавливать Docker-контейнеры и узлы YDB на хосте
- Изменяющие инструменты применяют DDL и восстановление данных после подтверждения confirm: true
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Тулкит дополняет официальный сервер 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.
Частые вопросы
Чем отличается от официального ydb-platform/ydb-mcp?
Официальный сервер дает общие инструменты уровня базы вроде произвольных SQL-запросов к существующему эндпоинту YDB, а этот тулкит управляет самим Docker-развертыванием local-ydb: узлами, DDL, дампом и восстановлением.
Инструменты меняют данные без подтверждения?
Нет, изменяющие инструменты сначала показывают план операции и выполняются только после явного confirm: true.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
YDB — все инструментыДемо MCP-подключения к YDB на примере заметок
Simple CLI Notes Application with YDB
Официальный пример YDB: docker compose поднимает базу YDB и MCP-сервер ydb-mcp, а Cursor через них выполняет SQL прямо из чата
Официальный MCP-сервер YDB
YDB MCP
Официальный MCP-сервер YDB от разработчиков базы: SQL-запросы с параметрами, план выполнения, обзор директорий и основа для своих серверов
Официальный MCP-сервер долгой памяти для агентов на базе YDB Serverless: mem0 извлекает факты, YDB хранит векторы
Документация Yandex Cloud в MCP: офлайн-поиск по SQLite
yandex-cloud-docs-mcp
Офлайн MCP-сервер с полнотекстовым поиском по локальной копии документации Yandex Cloud: без сети, только чтение, цитаты со строками
CLI-плагин docker mcp и шлюз: MCP-серверы из каталога Docker в изолированных контейнерах через одну точку подключения
MCP-серверы Yandex Cloud
Yandex Cloud MCP Servers
Официальный набор MCP-серверов Yandex Cloud: документация, поиск, развертывание приложений, serverless-функции, контейнеры и каталог данных
Коротко о README
README на английском отдельным разделом Relationship to ydb/ydb-mcp разграничивает зоны ответственности с официальным сервером, описывает три поверхности установки: Agent Plugin для Codex, плагин Claude Code и расширение Gemini CLI, а также экшен setup-local-ydb для GitHub Actions, и подробно объясняет требования к абсолютному пути конфигурации и правило подтверждения для изменяющих инструментов.