Каталог MCP
astandrik/local-ydb-toolkit

astandrik/local-ydb-toolkit

Name: astandrik/local-ydb-toolkit
Availability: InStock
Author: astandrik

MCP-сервер для управления Docker-инстансами local-ydb: создание тестовых YDB баз, управление схемами, дамп и восстановление. Полезен разработчикам для локального тестирования и CI на GitHub Actions.

Github NPM Сайт сервера

README

39 инструментов

Версии

Установить сервер

local-ydb-toolkit

Toolkit for operating local-ydb deployments across Codex, MCP clients, and GitHub Actions CI.

Website: local-ydb-toolkit.ydb-qdrant.tech.

Security policy — supported versions, private vulnerability reporting, and the local process trust boundary.

Privacy policy — data handling for the website and public skills-only package. For support, use GitHub Issues and do not include credentials or other sensitive data.

It includes:

a reusable Codex skill for local and SSH local-ydb operations;
an unofficial local stdio MCP server published as @astandrik/local-ydb-mcp;
a Marketplace GitHub Action, astandrik/setup-local-ydb, for booting disposable YDB tenants in CI.

Discovery and trust

The maintained listing hub, including third-party directory status and freshness notes, is on the project website. External scores, tool counts, and install metrics are directory snapshots, not security attestations.

VerifyMCP reports automated checks of the published npm package, including provenance and MCP schema checks. Its score is not a security certification or a verification of operations against a configured Docker/YDB deployment.

Инструменты были проиндексированы: 21.10.2026

local_ydb_add_dynamic_nodesвнешний мир

Добавляет одноразовые динамические узлы tenant поверх декларативной топологии profile.dynamicNodeCount, по одному за раз. По умолчанию первый суффикс — dynamicNodeCount + 1; явный startIndex должен быть больше dynamicNodeCount, переназначение портов остаётся доступным. Каждое запланированное имя должно отличаться от статического контейнера, и все настроенные и одноразовые порты должны быть корректны и уникальны в общем сетевом пространстве имён. После каждой проверки наличия образа повторяет полную предварительную проверку статической совместимости в режиме только проверки, включая текущий идентификатор образа, непосредственно перед запуском каждого узла; несовпадение останавливает этот узел и все последующие, требуется уничтожить и пересобрать. Каждый динамический контейнер создаётся, но не запускается, пока его разрешённый идентификатор образа не совпадёт со статическим контейнером — это закрывает состояние гонки при одновременном обновлении именованного тега. Без confirm=true возвращает планы контейнеров и портов; с confirm=true каждый узел должен иметь стабильно запущенный точный Docker-контейнер и его порт IC в viewer/json nodelist, прежде чем проверяются метаданные tenant.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
countinteger
Количество дополнительных динамических узлов для добавления. По умолчанию: 1.
grpcPortStartinteger
Порт gRPC для первого добавленного узла. По умолчанию равен profile.dynamicGrpc + startIndex - 1.
icPortStartinteger
Порт межсоединения для первого добавленного узла. По умолчанию равен profile.dynamicIc + startIndex - 1.
monitoringPortStartinteger
Порт мониторинга для первого добавленного узла. По умолчанию равен profile.dynamicMonitoring + startIndex - 1.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
startIndexinteger
Суффикс для первого добавленного контейнера. Он должен быть больше, чем profile.dynamicNodeCount. По умолчанию равен profile.dynamicNodeCount + 1, что дает <dynamicContainer>-<dynamicNodeCount + 1>.

local_ydb_add_storage_groupsвнешний мир

Увеличивает NumGroups для одного пула хранения арендатора, используя текущее определение ReadStoragePool. Без confirm=true эта операция возвращает план DefineStoragePool, откат, целевой пул и целевое количество; когда обновление выполнено успешно, она проверяет NumGroups и метаданные арендатора.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
countinteger
Количество добавляемых групп хранения. По умолчанию 1.
poolNamestring
Явное имя пула хранения. По умолчанию используется <tenantPath>:<storagePoolKind>.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_apply_auth_hardeningвнешний мир

Применяет проверенный укрепленный конфигурационный файл YDB только после того, как полная проверка статического профиля в режиме только проверки (check-only) и проверка совместимости настроенных привязок (configured-binding compatibility preflight) пройдут успешно до любых изменений конфигурации или контейнера; неизменяемые несоответствия требуют уничтожения (destroy) с последующей перезагрузкой (bootstrap). Затем перезапускает статический узел и заново создает и проверяет каждый настроенный динамический узел в порядке индекса, даже если файл токена динамического узла не настроен. Стабильность работы Exact-container и регистрация IC должны пройти успешно до проверки метаданных, а откат использует перезапуск или согласование при загрузке (bootstrap reconciliation) после восстановления статической конфигурации. Использует только после подготовки и проверки конфигурации; без confirm=true возвращает только план preflight/apply/recreate.

Параметры

configHostPathstring
Проверяет путь к config.yaml на выбранном целевом хосте. По умолчанию использует profile.authConfigPath, если он присутствует.
configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true, чтобы применить конфигурацию усиления аутентификации и перезапустить local-ydb. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_apply_schemaвнешний мир

Проверяет или применяет DDL таблиц YDB через официальный YDB JS SDK. Принимает сырой YQL DDL для PRAGMA, а также CREATE TABLE, ALTER TABLE и DROP TABLE; action=apply сначала проверяет, а выполняет только при confirm=true.

Параметры

actionenum
Операция над схемой для выполнения. validate только проверяет YQL DDL через YDB SDK; apply сначала проверяет и выполняет только при confirm=true.
configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true, чтобы выполнить action=apply после успешной проверки SDK. Опустите параметр или укажите false, если нужна только проверка и вывод плана.
databasePathstring
Путь к базе данных YDB для проверки/использования SDK. По умолчанию берется корень настроенного тенанта; корневые пути базы данных используют статический порт gRPC.
maxOutputBytesinteger
Максимальное количество байт UTF-8, возвращаемых на один поток проблем валидации/исполнения. По умолчанию: 65536.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
scriptstringобязательный
YQL DDL-скрипт для проверки или применения. Поддерживает PRAGMA, а также операторы CREATE TABLE, ALTER TABLE и DROP TABLE. Note: I should write in correct Russian. Need to ensure "YQL DDL-скрипт" is actually "YQL DDL-скрипт" but the original is "YQL DDL script". I'll keep as "YQL DDL-скрипт". Also "PRAGMA" is correct. Also "ALTER" etc. So final: "YQL DDL-скрипт для проверки или применения. Поддерживает PRAGMA, а также операторы CREATE TABLE, ALTER TABLE и DROP TABLE." I'll output thatYQL DDL-скрипт для проверки или применения. Поддерживает PRAGMA, а также операторы CREATE TABLE, ALTER TABLE и DROP TABLE.
timeoutMsinteger
Тайм-аут операции SDK в миллисекундах. По умолчанию 120000.

local_ydb_auth_checkтолько чтениеидемпотентныйвнешний мир

Аудит аутентификации только для чтения — проверяет статус whoami анонимного просмотрщика и настроенный доступ к тенанту YDB CLI, используя root-учётные данные, когда настроен rootPasswordFile. Используйте после усиления аутентификации или смены пароля, чтобы проверить ожидаемое состояние.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_bootstrapидемпотентныйвнешний мир

Создаёт топологию тенанта: статический узел с флагами GraphShard и loopback-б индингами для статического и каждого настроенного динамического gRPC-порта, настроенный CMS-тенант и все динамические узлы, объявленные через profile.dynamicNodeCount. Перед возвратом или выполнением плана имена настроенных контейнеров должны отличаться от статического контейнера, а все порты shared-network должны быть корректными и уникальными. Узлы запускаются в порядке индексов; перед запуском следующего узла готовность требует, чтобы точный Docker-контейнер был запущен, не перезапускался, был стабильным по container ID и RestartCount на протяжении двух проверок и зарегистрирован по своему IC-порту в viewer/json nodelist. Существующий запущенный или остановленный статический контейнер повторно используется только после полной проверки совместимости профилей, включая каждое настроенное gRPC-связывание. Используйте только для сценариев с тенантом, GraphShard, dump/restore или динамическими узлами; без confirm=true возвращает полный план и ничего не создаёт.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_bootstrap_root_databaseидемпотентныйвнешний мир

Разворачивает простую локальную базу данных YDB в /local только со статическим узлом. Используется для обычных запросов к локальной базе, которым не нужен арендатор CMS, GraphShard или динамические узлы; без confirm=true возвращает префлайт образа, сеть Docker/хранилище/статический узел и план проверки без выполнения.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_check_prerequisitesидемпотентныйвнешний мир

Проверяет предварительные требования целевого хоста для Docker, curl, ruby и настроенного rootPasswordFile, если он присутствует. Без confirm=true возвращает проверки, отсутствующие элементы, ручные действия и любой план установки apt-get; с confirm=true может устанавливать только поддерживаемые пакеты curl/ruby и никогда не устанавливает Docker.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_cleanup_storageвнешний мир

Удаляет только явно указанные host-пути local-ydb или Docker-тома. Используйте после проверки local_ydb_storage_leftovers; без confirm=true возвращает план очистки и ничего не удаляет.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Установите true, чтобы удалить явно указанные пути хранения или Docker-тома. Если параметр опущен или равен false, будет только план.
pathsstring[]
Явно указанные пути файловой системы хоста для удаления. Ничего не удаляется, пока каждый путь не указан здесь и confirm=true.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
volumesstring[]
Явные имена томов Docker для удаления. Ничего не удаляется, пока каждый том не указан здесь и confirm=true.

local_ydb_container_logsтолько чтениеидемпотентныйвнешний мир

Читает последние логи Docker из настроенного статического или основного динамического контейнера local-ydb. Используйте, когда загрузка, перезапуск или проверки готовности завершаются с ошибкой; target выбирает роль контейнера, а lines управляет количеством строк в конце.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
linesinteger
Количество последних строк лога для чтения. По умолчанию — 200.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
targetenumобязательный
Роль контейнера, из которой читаются логи: статический узел или основной динамический узел тенанта.

local_ydb_create_tenantидемпотентныйвнешний мир

Создаёт настроенного тенанта CMS, когда статический узел уже запущен. Используется перед local_ydb_start_dynamic_node для топологий тенантов; без confirm=true это возвращает запланированный статус/команду создания и ничего не создаёт.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_database_statusтолько чтениеидемпотентныйвнешний мир

Статус админской базы данных YDB только для чтения для заданного пути тенанта. Возвращает команду, stdout, stderr и флаг ok; используйте это для проверки состояния тенанта перед устранением неполадок при загрузке/перезапуске, а для проверки доступности схемы используйте local_ydb_tenant_check.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_destroy_stackвнешний мир

Удаляет метаданные тенанта, контейнеры local-ydb, сеть и хранилище для профиля, с опциональной очисткой путей хоста.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
removeAuthArtifactsboolean
Удаляет явно заданные authConfigPath, dynamicNodeAuthTokenFile и rootPasswordFile, когда они настроены. По умолчанию false.
removeBindMountPathboolean
Удаляет profile.bindMountPath, когда профиль использует bind mount. По умолчанию false.
removeDumpHostPathboolean
Удаляет profile.dumpHostPath. По умолчанию false, так как он может быть общим.

local_ydb_dump_tenantвнешний мир

Выгружает настроенный тенант или путь относительно тенанта, используя вспомогательный контейнер local-ydb в статической контейнерной сети. Создаёт profile.dumpHostPath/dumpName, исключает объекты .sys, записывает дамп в dumpName/tenant, а без confirm=true возвращает только план mkdir/helper-container.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true, чтобы выполнить дамп тенанта. Если параметр опущен или равен false, вывод будет содержать только план.
dumpNamestring
Необязательное имя каталога дампа в profile.dumpHostPath.
pathstring
Относительный путь к объекту YDB или каталогу для выгрузки внутри настроенного тенанта. По умолчанию используется . для семантики выгрузки всего тенанта.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_generate_schemaтолько чтениеидемпотентныйвнешний мир

Генератор DDL для таблиц YDB в режиме только для чтения. Он формирует строгие JSON-спецификации для CREATE TABLE, ALTER TABLE, DROP TABLE и вторичных индексов, возвращает сгенерированный скрипт с официальными ссылками и предупреждениями, а при необходимости может выполнить проверку через YDB JS SDK без применения изменений.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
databasePathstring
Путь к базе данных YDB, используемый при validate=true. По умолчанию это корень тенанта, заданный в конфигурации.
maxOutputBytesinteger
Максимальное количество байт UTF-8, возвращаемое для каждого потока ошибок проверки при validate=true. По умолчанию: 65536.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
statementsobject[]обязательный
Структурированные спецификации операторов схемы для преобразования в DDL таблиц YDB.
timeoutMsinteger
Таймаут валидации SDK в миллисекундах при validate=true. По умолчанию: 120000.
validateboolean
Если true, проверяет сгенерированный DDL через local_ydb_apply_schema action=validate. Этот инструмент никогда не применяет DDL.

local_ydb_graphshard_checkтолько чтениеидемпотентныйвнешний мир

Проверка GraphShard только для чтения через возможности viewer/json и tabletinfo для настроенного тенанта. Возвращает graphShardExists, идентификаторы таблеток и детали статуса viewer; используйте после начальной настройки тенанта, когда конкретный вопрос касается поддержки GraphShard или видимости таблеток.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_healthcheckтолько чтениеидемпотентныйвнешний мир

Только для чтения проверка работоспособности YDB для настроенного тенанта или корневой базы данных. Использует официальный путь SelfCheck CLI YDB, возвращает selfCheckResult, количество проблем, типы проблем, усечённый сырой вывод и информацию о том, здорова ли база данных; запрошенная опция noCache/noMerge отклоняется, точная распознанная двухстрочная сигнатура устаревшего парсера сообщается через optionResolution и warnings, а compatibilityFallback показывает, действительно ли началась повторная попытка. Используйте после local_ydb_status_report для диагностики на уровне базы данных.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
databasePathstring
Путь к базе данных YDB для проверки. По умолчанию используется настроенный путь тенанта; принимаются только настроенный путь тенанта или корневой путь базы данных.
maxIssuesinteger
Максимальное количество записей issue_log в поле issues. Счётчики по-прежнему отражают полный ответ. По умолчанию — 100.
maxOutputBytesinteger
Максимальное количество байт UTF-8, возвращаемых на один необработанный поток stdout/stderr. По умолчанию: 65536.
noCacheboolean
Запрашивает семантику обхода кэша для этой проверки работоспособности. Новые CLI YDB получают параметр --no-cache. Отказ, соответствующий точной сигнатуре устаревшего парсера из двух строк, фиксируется в optionResolution и предупреждениях; когда общий предельный срок позволяет повторить попытку без этого параметра, compatibilityFallback имеет значение true.
noMergeboolean
Запрашивает несвёрнутые пункты проверки состояния. Новые версии YDB CLI получают --no-merge. Отклонение, совпадающее с точной распознанной двухстрочной сигнатурой устаревшего парсера, фиксируется в optionResolution и warnings; когда общий лимит времени позволяет повторить попытку без этой опции, compatibilityFallback имеет значение true.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
timeoutMsinteger
Таймаут проверки работоспособности YDB на стороне сервера в миллисекундах. По умолчанию: 120000.

local_ydb_inventoryтолько чтениеидемпотентныйвнешний мир

Инвентаризация Docker только для чтения для целевого профиля local-ydb. Возвращает публичный профиль, контейнеры и тома Docker, видимые на выбранной цели, а также данные inspect для настроенных статических и основных динамических контейнеров; используйте перед инструментами, изменяющими состояние, чтобы зафиксировать текущее состояние стека.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_list_dumpsтолько чтениеидемпотентныйвнешний мир

Список доступных дампов тенантов по пути profile.dumpHostPath только для чтения. Используйте перед восстановлением, чтобы выбрать dumpName; он сообщает только о каталогах дампов верхнего уровня, содержащих существующую папку дампа тенанта.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_list_versionsтолько чтениеидемпотентныйвнешний мир

Перечисляет опубликованные теги GHCR или Docker Hub для образа контейнера local-ydb, причём числовые теги версий сортируются от новых к старым. Используется перед local_ydb_upgrade_version. Пагинация и аутентификация реестра ограничены доверенными источниками, а pageSize и maxPages ограничивают пагинацию.

Параметры

imagestring
Имя образа контейнера в GHCR или Docker Hub для проверки. По умолчанию используется ghcr.io/ydb-platform/local-ydb.
maxPagesinteger
Максимальное количество страниц реестра, получаемых до усечения результата. По умолчанию: 10.
pageSizeinteger
Запрашиваемые теги на страницу реестра. По умолчанию: 100.

local_ydb_nodes_checkтолько чтениеидемпотентныйвнешний мир

Проверка регистрации динамических узлов в режиме только для чтения через viewer/json nodelist. Используйте после запуска, добавления или удаления динамических узлов; сначала используйте local_ydb_tenant_check, если доступность тенанта неизвестна.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_permissionsвнешний мир

Проверить или изменить права доступа к схеме YDB для пути. Действие list по умолчанию — только чтение; grant, revoke, set, clear, chown и изменения наследования возвращают план, за исключением случаев, когда confirm=true.

Параметры

actionenum
Операция с разрешениями для выполнения. По умолчанию используется значение list, которое доступно только для чтения и не требует подтверждения.
configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения изменяющих действий. Опустите или false для вывода только плана. Не требуется для action=list.
maxOutputBytesinteger
Для action=list, максимальное количество байт UTF-8, возвращаемых на каждый поток stdout/stderr. По умолчанию — 65536.
ownerstring
Новый владелец для действия chown.
pathstring
Путь схемы для управления. По умолчанию — корень настроенного тенанта.
permissionsstring[]
Имена разрешений для действий предоставления, отзыва и установки. Каждый элемент передаётся как отдельный аргумент -p.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
subjectstring
Субъект (пользователь или группа) для действий предоставления, отзыва и установки.

local_ydb_prepare_auth_configвнешний мир

Генерирует hardened-конфигурацию YDB из текущей static-node конфигурации. Используйте перед local_ydb_write_dynamic_auth_config и local_ydb_apply_auth_hardening; без confirm=true этот инструмент возвращает только запланированную запись.

Параметры

configHostPathstring
Путь на хосте к сгенерированной усиленной конфигурации. По умолчанию используется profile.authConfigPath, если он задан.
configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Чтобы записать укреплённый конфигурационный файл, значение должно быть true. Опустите параметр или укажите false, чтобы получить только план.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
sidstring
SID для указания в viewer, monitoring, administration и register_dynamic_node_allowed_sids. По умолчанию используется profile.dynamicNodeAuthSid или root@builtin.

local_ydb_pull_imageвнешний мир

Планирует или запускает фоновую загрузку Docker образа local-ydb на выбранной цели. Без confirm=true возвращает только команды inspect и pull; с confirm=true возвращает jobId для local_ydb_pull_status, если образ ещё не присутствует.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true, чтобы запустить фоновую загрузку Docker. Опустите параметр или укажите false для вывода только плана.
imagestring
Образ контейнера для загрузки. По умолчанию используется образ выбранного профиля.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_pull_statusтолько чтениеидемпотентныйвнешний мир

Проверяет статус фоновой загрузки образа Docker, запущенной с помощью local_ydb_pull_image. Для известных задач возвращает монотонный progressPercent, основанный на загруженных известных слоях Docker, а не на байтах: 0-99 при выполнении, 100 после успешного завершения и последнее наблюдаемое значение после сбоя.

Параметры

jobIdstringобязательный
Идентификатор фоновой задачи pull, возвращаемый local_ydb_pull_image.

local_ydb_reduce_storage_groupsвнешний мир

Уменьшает NumGroups для пула хранения арендатора: делает дамп арендатора, перестраивает стек профилей с меньшим storagePoolCount, восстанавливает дамп и при необходимости повторно применяет аутентификацию. Перед дампом или удалением проверяет каждый отдельный динамический узел и сохраняет его точные порты gRPC, мониторинга и IC; неполное определение прерывает перестроение.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
countinteger
Количество групп хранения, удаляемых из текущего пула тенанта. По умолчанию: 1.
dumpNamestring
Необязательное имя каталога дампа в profile.dumpHostPath для сохранения перед пересборкой.
poolNamestring
Явное имя пула хранения. По умолчанию используется <tenantPath>:<storagePoolKind>.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_remove_dynamic_nodesвнешний мир

Удаляйте динамические суффиксы узлов tenant по одному и проверяйте исчезновение из nodelist, когда IC-порт узла удаётся разрешить. Без containers, nodeIds или startIndex подходят только разовые суффиксы, превышающие profile.dynamicNodeCount, и первым удаляется самый старший суффикс. Явные селекторы или startIndex могут удалить настроенный суффикс и вызвать расхождение, которое исправляется загрузкой (bootstrap) или перезапуском (restart). Рекомендации по откату: для настроенных узлов — bootstrap/restart, для разовых — add_dynamic_nodes с соответствующими суффиксами и портами. Основной dynamicContainer всегда защищён.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
containersstring[]
Явные суффиксы имена контейнеров dynamic-node для удаления. Настроенные суффиксы можно выбрат, и они станoвятся рантайм-дрейфом; при этoм oснoвнoй dynamicContainer прoфиля oстается защищенным.
countinteger
Число динамических узлов, которые будут удалены, если containers и nodeIds не заданы. По умолчанию: 1.
nodeIdsinteger[]
Явные ID динамических узлов YDB для удаления. ID могут указывать на настроенные или разовые контейнеры с суффиксом; основной dynamicContainer профиля через эту опцию удалить нельзя.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
startIndexinteger
Минимальный суффикс, который считается удаляемым. Без явных containers или nodeIds по умолчанию используется profile.dynamicNodeCount + 1, поэтому настроенные суффиксы исключаются. Явные селекторы по умолчанию равны 2. Явный startIndex всегда переопределяет любое из значений по умолчанию.

local_ydb_restart_stackвнешний мир

Выполняет сверку и перезапускает выбранный профиль после инвентаризации и полной предварительной проверки статической совместимости в режиме только проверки. Перед остановкой любого контейнера требует, чтобы существующий статический контейнер соответствовал образу профиля, сети, точке монтирования данных, окружению, политике перезапуска, healthcheck и точным привязкам loopback для статического gRPC, мониторинга и каждого настроенного динамического порта gRPC; изменения настроенных привязок требуют уничтожения с последующей начальной загрузкой. Затем сообщает об отсутствующих настроенных и неожиданных одноразовых динамических контейнерах, останавливает работающие динамические контейнеры до статических, безусловно воссоздаёт каждый настроенный узел в порядке индекса, включая контейнеры, замеченные при перезапуске, требует, чтобы каждый точный Docker-контейнер стабильно работал и был зарегистрирован по порту IC, и восстанавливает только ранее работавшие неожиданные контейнеры, не удаляя их. Поскольку удалённые настроенные определения невозможно восстановить из инвентаризации, откат использует сверку при перезапуске или начальной загрузке. Без confirm=true возвращает только план перезапуска.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_restore_tenantвнешний мир

Восстанавливает настроенный тенант или путь назначения из дампа по адресу profile.dumpHostPath, с возможностью описать схему после восстановления и выполнить проверку с ограниченным подсчётом запросов. Используйте после начальной загрузки или пересборки, когда целевой тенант готов; без confirm=true эта команда возвращает план восстановления и не записывает данные.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true, чтобы восстановить тенант из выбранного дампа. Опустите параметр или укажите false, чтобы получить только план.
countQueriesobject[]
Необязательные ограниченные запросы SELECT COUNT(*) или COUNT(1) по всей таблице для проверки восстановленных данных после команды восстановления.
describePathsstring[]
Необязательные пути относительно тенанта для проверки с помощью scheme describe после команды restore.
dumpNamestringобязательный
Имя каталога дампа в profile.dumpHostPath.
pathstring
Путь к каталогу назначения для restore -p инструментов YDB, относительно настроенного тенанта. По умолчанию используется . для корня тенанта.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_schemeтолько чтениеидемпотентныйвнешний мир

Список или описание схемы YDB только для чтения с ограничением stdout/stderr. Использует корневую базу данных для путей rootDatabase и базу данных тенанта в остальных случаях; list поддерживает флаги recursive/long/onePerLine, describe поддерживает stats, и несовместимые комбинации флагов отклоняются.

Параметры

actionenum
Операция Scheme для запуска. По умолчанию: list.
configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
longboolean
Для action=list передайте параметр -l, чтобы получить подробные атрибуты объекта.
maxOutputBytesinteger
Максимальное количество байт UTF-8, возвращаемых для каждого потока stdout/stderr. По умолчанию: 65536.
onePerLineboolean
pathstring
Путь схемы для проверки. По умолчанию используется корень настроенного тенанта.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
recursiveboolean
Для action=list, передайте -R, чтобы рекурсивно перечислить подкаталоги.
statsboolean
Для action=describe передайте --stats.

local_ydb_set_root_passwordвнешний мир

Вращайте пароль корневого пользователя времени выполнения с помощью ALTER USER и синхронизируйте конфигурацию аутентификации хоста и файл пароля корневого пользователя для соответствия. YDB может отклонить пароли, нарушающие auth_config.password_complexity; этот инструмент требует непустого значения пароля.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Установите true, чтобы ротировать и сохранить пароль root. Опустите параметр или укажите false, чтобы получить вывод только плана.
passwordstringобязательный
Новый непустой пароль root без возвратов каретки и переводов строк применяется к пользователю root во время выполнения, а затем сохраняется в конфигурации аутентификации хоста и файле пароля root. По умолчанию YDB не предъявляет требований к сложности пароля, но выбранный кластер может отклонить значение, если настроен auth_config.password_complexity.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_sqlвнешний мир

Выполняет управляемый YQL v1 для настроенной цели local-ydb через Query Service. query использует SnapshotRO, explain возвращает план/AST, а execute всегда сначала выполняет EXPLAIN и отправляет только одно выполнение NoTx с confirm=true.

Параметры

actionenum
Управляемое действие YQL. query использует SnapshotRO, explain возвращает план/AST без выполнения, а execute всегда выполняет EXPLAIN-предпроверку перед опциональным подтверждённым выполнением NoTx.
configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Учитывается только для action=execute. Должно быть true, чтобы после успешного EXPLAIN отправить одно выполнение NoTx; запрос остаётся SnapshotRO, даже когда true.
databasePathstring
Настроенный путь к базе данных тенанта или корневой базе данных. По умолчанию используется путь тенанта выбранного профиля; корневые пути используют статический gRPC-порт.
maxOutputBytesinteger
Общий бюджет сохраняемых выходных данных для задач, плана/AST, столбцов и строк.
maxRowsinteger
Максимальное количество сохраняемых строк на набор результатов. При первом достижении лимита захват всех дальнейших результатов прекращается: выполнение в режиме только для чтения отменяется, а подтверждённое выполнение NoTx дорабатывает, не захватывая последующий вывод.
parametersobject
Типизированные параметры YQL с ключами по простым именам. Запрос ограничен 100 параметрами, 1 000 узлов описания, 10 000 узлов значений и 1 МиБ сериализованных данных параметров. Имена полей структур должны быть корректным Unicode. Значения используют документированное JSON-представление и никогда не отражаются в метаданных ответа. Числа Json/JsonDocument должны быть конечными, целые значения должны быть безопасными целыми числами JavaScript, а отрицательный ноль отклоняется, потому что JSON-кодирование не может сохранить его знак.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
scriptstringобязательный
Скрипт YQL v1 должен быть корректным Unicode; одинокие UTF-16 суррогаты отклоняются. Инструкции DECLARE для параметров генерируются из параметров и вставляются в начало скрипта перед выполнением.
timeoutMsinteger
Единый срок в миллисекундах, общий для соединения, сеанса, preflight, выполнения и отмены.

local_ydb_start_dynamic_nodeидемпотентныйвнешний мир

Запускает настроенный первичный динамический узел-тенант для существующего CMS-тенанта. Перед возвратом или выполнением плана отклоняет первичное имя, которое ссылается на статический контейнер, и порты, конфликтующие в общем сетевом пространстве имен, включая статический IC-порт 19001. После проверки наличия образа выполняет полную статическую проверку совместимости (только проверка, без запуска), включая текущий ID образа, непосредственно перед запуском динамического контейнера; несоответствие приводит к закрытой ошибке, требующей уничтожения с последующей загрузкой. Динамический контейнер создается, но не запускается, пока его разрешенный ID образа не совпадет с ID статического контейнера, что закрывает гонку конкурентного обновления именованного тега. Используйте после local_ydb_create_tenant или когда статус администратора — PENDING_RESOURCES; используйте local_ydb_add_dynamic_nodes для дополнительных узлов. Без confirm=true возвращает только план.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true для выполнения запланированных команд. Опустите или укажите false для вывода только плана.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_status_reportтолько чтениеидемпотентныйвнешний мир

Агрегированный отчёт только для чтения для быстрой диагностики. Запускает local_ydb_inventory, local_ydb_auth_check, local_ydb_tenant_check, local_ydb_nodes_check и local_ydb_healthcheck, возвращая каждый результат; используйте его в первую очередь для оценки общего состояния стека, затем выполняйте целенаправленные проверки для статуса баз данных, GraphShard, хранилища или логов.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_storage_leftoversтолько чтениеидемпотентныйвнешний мир

Поиск только для чтения оставшихся локальных Docker-томов local-ydb, дампов и путей PDisk/data. Сканирует имена Docker-томов и profile.storageSearchPaths, ничего не удаляет; используйте перед local_ydb_cleanup_storage, чтобы определить точные пути или тома для удаления.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_storage_placementтолько чтениеидемпотентныйвнешний мир

Инспекция хранилища только для чтения, которая возвращает вывод ReadStoragePool и физическое размещение BSC. Используйте перед добавлением или сокращением групп хранения, чтобы подтвердить точную форму пула.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_tenant_checkтолько чтениеидемпотентныйвнешний мир

Проверка только на чтение, использующая YDB CLI для подтверждения доступности настроенного пути к тенанту. Используйте после начальной загрузки (bootstrap) или восстановления, чтобы подтвердить метаданные тенанта перед проверками узлов (node) или GraphShard.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.

local_ydb_upgrade_versionвнешний мир

Обновляет файловый или томовый профиль local-ydb до целевого тега образа. Используется только для обновления версий на профилях без bindMountPath; перед дампом или уничтожением проверяет каждый одноразовый динамический узел и сохраняет его точные gRPC, мониторинг и IC порты, прерываясь при неполном определении. Затем выполняет предварительную проверку исходного и целевого образов, дамп, пересборку, восстановление, повторное применение аутентификации (если настроена), пересоздание дополнительных узлов и финальную верификацию образа. Подтверждённое несоответствие оставляет профиль без изменений; если после успешных этапов пересборки финальный инвентарь недоступен, ответ сохраняет историю команд, сообщает о частичной верификации и сохраняет целевой образ профиля.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true, чтобы выполнить план обновления версии. Если параметр опущен или задан как false, будет выведен только план.
dumpNamestring
Необязательное имя каталога дампа в profile.dumpHostPath для резервной копии при обновлении.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
versionstringобязательный
Тег целевого образа, возвращаемый local_ydb_list_versions.

local_ydb_write_dynamic_auth_configвнешний мир

Записывает файл токена аутентификации text-proto dynamic-node, необходимый для запуска mandatory-auth. Используется после выбора SID для усиления аутентификации; без confirm=true возвращает только запланированную запись файла.

Параметры

configPathstring
Абсолютный путь к явно указанному файлу конфигурации local-ydb. Если файл отсутствует, не читается, слишком большой или невалидный, работа завершается с ошибкой, а не используются значения по умолчанию.
confirmboolean
Должно быть true, чтобы записать файл токена аутентификации dynamic-node. Если опущено или false, вывод будет только планом.
profilestring
Именованный профиль из local-ydb.config.json. По умолчанию используется config.defaultProfile.
sidstring
SID, который нужно сохранить и в StaffApiUserToken, и в NodeRegistrationToken.
tokenHostPathstring
Путь на хосте для генерируемого файла токена аутентификации в формате text-proto. По умолчанию используется profile.dynamicNodeAuthTokenFile, если он присутствует.

`0.19.0`основная	07.10.2026
`0.18.2`	26.08.2026
`0.18.1`	22.08.2026
`0.18.0`	21.08.2026
`0.17.0`	20.08.2026
`0.16.1`	20.08.2026
`0.16.0`	16.08.2026
`0.15.4`	12.08.2026
`0.15.3`	12.08.2026
`0.15.2`	05.08.2026
`0.15.1`	05.08.2026
`0.15.0`	03.08.2026
`0.14.1`	13.07.2026
`0.14.0`	13.06.2026
`0.13.1`	10.06.2026
`0.13.0`	28.05.2026
`0.12.3`	28.05.2026
`0.12.2`	28.05.2026
`0.12.1`	28.05.2026
`0.12.0`	28.05.2026
`0.11.0`	27.05.2026
`0.10.0`	20.05.2026
`0.9.7`	20.05.2026
`0.9.6`	19.05.2026
`0.9.5`	19.05.2026
`0.9.4`	18.05.2026
`0.9.3`	18.05.2026
`0.9.2`	18.05.2026
`0.9.1`	18.05.2026
`0.9.0`	17.05.2026
`0.8.0`	16.05.2026
`0.7.2`	09.05.2026
`0.7.1`	09.05.2026
`0.7.0`	28.04.2026
`0.6.0`	28.04.2026
`0.5.0`	27.04.2026
`0.4.0`	27.04.2026
`0.3.2`	26.04.2026
`0.3.1`	26.04.2026
`0.3.0`	26.04.2026
`0.2.2`	26.04.2026
`0.2.1`	26.04.2026
`0.2.0`	26.04.2026
`0.1.0`	26.04.2026

Выберите клиент, чтобы установить astandrik/local-ydb-toolkit:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "astandrik-local-ydb-toolkit-00mcik0ks7": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ],
      "env": {
        "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
        "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "astandrik-local-ydb-toolkit-00mcik0ks7": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ],
      "env": {
        "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
        "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "astandrik-local-ydb-toolkit-00mcik0ks7": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ],
      "env": {
        "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
        "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"astandrik-local-ydb-toolkit-00mcik0ks7\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"--prefer-online\",\"@astandrik/local-ydb-mcp@latest\"],\"env\":{\"LOCAL_YDB_TOOLKIT_CONFIG\":\"/path/to/local-ydb.config.json\",\"LOCAL_YDB_MCP_CONTENT_FORMAT\":\"toon\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "astandrik-local-ydb-toolkit-00mcik0ks7": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ],
      "env": {
        "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
        "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add astandrik-local-ydb-toolkit-00mcik0ks7 --env LOCAL_YDB_TOOLKIT_CONFIG=/path/to/local-ydb.config.json --env LOCAL_YDB_MCP_CONTENT_FORMAT=toon -- npx -y --prefer-online @astandrik/local-ydb-mcp@latest

Либо через JSON-конфиг:

claude mcp add-json astandrik-local-ydb-toolkit-00mcik0ks7 "{\"command\":\"npx\",\"args\":[\"-y\",\"--prefer-online\",\"@astandrik/local-ydb-mcp@latest\"],\"env\":{\"LOCAL_YDB_TOOLKIT_CONFIG\":\"/path/to/local-ydb.config.json\",\"LOCAL_YDB_MCP_CONTENT_FORMAT\":\"toon\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add astandrik-local-ydb-toolkit-00mcik0ks7 --env LOCAL_YDB_TOOLKIT_CONFIG=/path/to/local-ydb.config.json --env LOCAL_YDB_MCP_CONTENT_FORMAT=toon -- npx -y --prefer-online @astandrik/local-ydb-mcp@latest

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.astandrik-local-ydb-toolkit-00mcik0ks7]
command = "npx"
args = ["-y", "--prefer-online", "@astandrik/local-ydb-mcp@latest"]

[mcp_servers.astandrik-local-ydb-toolkit-00mcik0ks7.env]
LOCAL_YDB_TOOLKIT_CONFIG = "/path/to/local-ydb.config.json"
LOCAL_YDB_MCP_CONTENT_FORMAT = "toon"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите astandrik/local-ydb-toolkit, а в поле команды запуска — строку ниже:

npx -y --prefer-online @astandrik/local-ydb-mcp@latest

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "astandrik-local-ydb-toolkit-00mcik0ks7": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ],
      "env": {
        "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
        "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "astandrik-local-ydb-toolkit-00mcik0ks7": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ],
      "env": {
        "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
        "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например astandrik-local-ydb-toolkit-00mcik0ks7.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: astandrik-local-ydb-toolkit-00mcik0ks7
    command: npx
    args:
      - "-y"
      - "--prefer-online"
      - "@astandrik/local-ydb-mcp@latest"
    env:
      LOCAL_YDB_TOOLKIT_CONFIG: /path/to/local-ydb.config.json
      LOCAL_YDB_MCP_CONTENT_FORMAT: toon

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "astandrik-local-ydb-toolkit-00mcik0ks7": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ],
      "env": {
        "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
        "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "--prefer-online",
    "@astandrik/local-ydb-mcp@latest"
  ],
  "env": {
    "LOCAL_YDB_TOOLKIT_CONFIG": "/path/to/local-ydb.config.json",
    "LOCAL_YDB_MCP_CONTENT_FORMAT": "toon"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx