Local YDB MCP — MCP-сервер для Claude Code
Управляет локальными инстансами YDB в Docker через stdio-протокол. Помогает поднимать тестовые базы, проверять топологию и накатывать миграции.
claude mcp add --env LOCAL_YDB_TOOLKIT_CONFIG=<LOCAL_YDB_TOOLKIT_CONFIG> --env LOCAL_YDB_MCP_CONTENT_FORMAT=<LOCAL_YDB_MCP_CONTENT_FORMAT> --transport stdio mcp-server -- npx -y @astandrik/local-ydb-mcpЧто делает Local YDB MCP
Сервер предназначен для администрирования локальных сред YDB, развёрнутых через Docker или SSH. В отличие от пакета ydb-platform/ydb-mcp, ориентированного на стандартные SQL-запросы к рабочей базе, этот инструмент управляет жизненным циклом самого контейнера: от предварительной проверки окружения и инициализации тенантов до сбора логов и обновления образов.
Внутри реализовано 39 инструментов и готовые шаблоны промптов для пошаговой диагностики. Любые изменяющие операции спроектированы безопасно: они сначала возвращают план действий и требуют явного параметра confirm: true для фактического применения изменений в базе.
Для запуска потребуется Node.js версии не ниже 20.19. Конфигурацию можно передать через переменную LOCAL_YDB_TOOLKIT_CONFIG, при этом путь обязан быть абсолютным, а сам файл — корректным JSON размером до 1 МБ.
Какие задачи решает
- развернуть локальный кластер YDB в Docker
- собрать диагностику и логи упавшего контейнера
- проверить доступность схемы и состояние тенанта
- применить DDL к локальной базе с подтверждением плана
Примеры запросов агенту
- Проверь состояние локального контейнера YDB и покажи сводный отчёт о здоровье системы.
- Выведи последние 50 строк логов основного контейнера через local_ydb_container_logs.
- Проверь доступность пути тенанта с помощью инструмента local_ydb_tenant_check.
Как установить Local YDB MCP
Командой платформы
claude mcp add --env LOCAL_YDB_TOOLKIT_CONFIG=<LOCAL_YDB_TOOLKIT_CONFIG> --env LOCAL_YDB_MCP_CONTENT_FORMAT=<LOCAL_YDB_MCP_CONTENT_FORMAT> --transport stdio mcp-server -- npx -y @astandrik/local-ydb-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-server --env LOCAL_YDB_TOOLKIT_CONFIG=<LOCAL_YDB_TOOLKIT_CONFIG> --env LOCAL_YDB_MCP_CONTENT_FORMAT=<LOCAL_YDB_MCP_CONTENT_FORMAT> -- npx -y @astandrik/local-ydb-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@astandrik/local-ydb-mcp"
],
"env": {
"LOCAL_YDB_TOOLKIT_CONFIG": "<LOCAL_YDB_TOOLKIT_CONFIG>",
"LOCAL_YDB_MCP_CONTENT_FORMAT": "<LOCAL_YDB_MCP_CONTENT_FORMAT>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@astandrik/local-ydb-mcp"
],
"env": {
"LOCAL_YDB_TOOLKIT_CONFIG": "<LOCAL_YDB_TOOLKIT_CONFIG>",
"LOCAL_YDB_MCP_CONTENT_FORMAT": "<LOCAL_YDB_MCP_CONTENT_FORMAT>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e LOCAL_YDB_TOOLKIT_CONFIG=<LOCAL_YDB_TOOLKIT_CONFIG> -e LOCAL_YDB_MCP_CONTENT_FORMAT=<LOCAL_YDB_MCP_CONTENT_FORMAT> mcp-server npx -y @astandrik/local-ydb-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Local YDB MCP
Как установить Local YDB MCP в Claude Code?
Выполните команду claude mcp add local-ydb-mcp -- npx -y @astandrik/local-ydb-mcp. Если нужен отдельный конфиг, добавьте флаг переменной: `claude mcp add --env LOCAL_YDB_TOOLKIT_CONFIG=<LOCAL_YDB_TOOLKIT_CONFIG> --env LOCAL_YDB_MCP_CONTENT_FORMAT=<LOCAL_YDB_MCP_CONTENT_FORMAT> --transport stdio mcp-server -- npx -y @astandrik/local-ydb-mcp`.
Чем этот сервер отличается от официального ydb-platform/ydb-mcp?
Официальный сервер выполняет аналитические SQL-запросы к готовому эндпоинту YDB. Этот пакет управляет инфраструктурой контейнера: проверяет ноды, выполняет бутстрап и следит за состоянием Docker.
Что нужно подготовить перед запуском?
Понадобится установленный Node.js 20.19 или новее и работающий Docker. Если задаёте файл конфигурации, он должен находиться по абсолютному пути и весить не более 1 МБ.
