Local Ydb Mcp
by astandrikcommunityv0.14.0
3
An unofficial local stdio MCP server and Codex skill for operating Docker-based or SSH-connected `local-ydb` deployments. It provides read-only inspection and plan-first mutating workflows for tasks like prerequisites checks, tenant/bootstrap operations, schema DDL generation/application, auth hardening, storage workflows, upgrades, and health diagnostics.
From the registry: Operate local-ydb deployments through local or SSH-backed MCP tools.
Install & configure
Prerequisites
- requiredInstall Node.js 20.19 or newerThe npm package for the MCP server requires Node.js 20.19 or newer.
- requiredCreate a local-ydb toolkit config fileCreate a configuration file for target profiles. The README says to start from examples/local-ydb.config.example.json and keep private hosts, SSH keys, password files, and backup paths outside committed config. Set LOCAL_YDB_TOOLKIT_CONFIG to this file path.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `local-ydb-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 20.19 or newer** — The npm package for the MCP server requires Node.js 20.19 or newer.
- **Create a local-ydb toolkit config file** — Create a configuration file for target profiles. The README says to start from examples/local-ydb.config.example.json and keep private hosts, SSH keys, password files, and backup paths outside committed config. Set LOCAL_YDB_TOOLKIT_CONFIG to this file path.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","--prefer-online","@astandrik/local-ydb-mcp@latest"]
- required environment variables:
- `LOCAL_YDB_TOOLKIT_CONFIG`: Path to the local-ydb toolkit configuration JSON file containing target profiles and defaults. (example: `<path-to-local-ydb.config.json>`)
- optional environment variables:
- `LOCAL_YDB_MCP_CONTENT_FORMAT`: Optional response text content format. Use toon to prefer TOON for LLM-facing text content; omit it or set json for the default pretty JSON text. (example: `<toon-or-json>`)
Note: Preferred install path is the npm package via npx. The server is a local stdio MCP server, not a remote endpoint. A global install via npm install -g @astandrik/local-ydb-mcp is also supported, but npx is the simplest portable option.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Preferred install path is the npm package via npx. The server is a local stdio MCP server, not a remote endpoint. A global install via npm install -g @astandrik/local-ydb-mcp is also supported, but npx is the simplest portable option.
Tools (5)
local_ydb_check_prerequisites
Checks host/profile prerequisites such as docker, curl, ruby, and auth-file requirements.
local_ydb_healthcheck
Runs YDB monitoring healthcheck against the configured tenant and returns database health and issue details.
local_ydb_list_versions
Lists available local-ydb image tags from the container registry.
local_ydb_scheme
Lists or describes schema objects using the YDB CLI.
local_ydb_generate_schema
Generates and optionally validates YDB table schema DDL from JSON specs without applying it.
Environment variables
LOCAL_YDB_TOOLKIT_CONFIGrequiredPath to the local-ydb toolkit configuration file used by the MCP server.LOCAL_YDB_MCP_CONTENT_FORMATrequiredControls MCP text content formatting; use toon or json.Prerequisites
- • Node.js 20.19
Packages
@astandrik/local-ydb-mcp
npmv0.14.0transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Jun 13, 2026
- Last commit
- Jun 23, 2026
- Registry name
- io.github.astandrik/local-ydb-mcp