Local YDB MCP
Operate Docker-based local YDB stacks from an agent, with plan-first changes and confirm
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.19.1
- Listing updated
- 3 days ago
About Local YDB MCP
Local YDB MCP is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.
This stdio server is for agents that need to run the local-ydb environment itself, not just query a database. The README places it beside the official ydb-platform/ydb-mcp: that server handles ad hoc SQL, query explanations and path inspection against an existing YDB endpoint, while this one covers host prerequisite checks, root or tenant bootstrap, health diagnostics, dynamic-node lifecycle, GraphShard checks, table DDL generation and validation, auth hardening, storage workflows, dump and restore, and version upgrades.
Anything that changes state returns a plan first and executes only when confirm: true is supplied. Its local_ydb_sql tool is deliberately narrower than the official one and runs managed YQL only against the selected configured profile. Intentional upgrades go through local_ydb_upgrade_version, which dumps and rebuilds the stack. A JSON config file, optionally pointed to by LOCAL_YDB_TOOLKIT_CONFIG, defines profiles; without one a default profile using a local-ydb image is used, and the README advises pinning the image explicitly.
Private config files, SSH settings, password files and database credentials stay on the machine or CI runner. It needs Node.js 20.19 or newer, can work locally or over SSH, and is described as unofficial. A companion Codex skill and a GitHub Action for disposable YDB in CI are published by the same project.
Install
Run in a terminal
claude mcp add local-ydb-mcp -- npx -y @astandrik/local-ydb-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"local-ydb-mcp": {
"command": "npx",
"args": [
"-y",
"@astandrik/local-ydb-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"local-ydb-mcp": {
"command": "npx",
"args": [
"-y",
"@astandrik/local-ydb-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"local-ydb-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@astandrik/local-ydb-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"local-ydb-mcp": {
"command": "npx",
"args": [
"-y",
"@astandrik/local-ydb-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"local-ydb-mcp": {
"command": "npx",
"args": [
"-y",
"@astandrik/local-ydb-mcp"
]
}
}
}Configuration
LOCAL_YDB_TOOLKIT_CONFIGOptional path to a local-ydb-toolkit config JSON file.LOCAL_YDB_MCP_CONTENT_FORMATOptional LLM-facing tool response text format. Use toon to prefer TOON for the second text content block, with JSON fallback if TOON cannot round-trip losslessly; omit or set json for pretty JSON. MCP JSON-RPC and structuredContent stay JSON.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- local_ydb_sql
- Run managed YQL against the selected local-ydb profile.
- local_ydb_upgrade_version
- Upgrade a stack by dump and rebuild.
What it does
- Plan-first changes
- Mutating tools return a plan and run only with confirm: true.
- Stack lifecycle
- Bootstrap root or tenant stacks, manage dynamic nodes and check health.
- Managed YQL
- local_ydb_sql runs YQL against the selected local profile only.
- Dump and upgrade
- Dump, restore and rebuild a stack for version upgrades.
- Local credentials
- Config, SSH settings and password files never leave your machine.
Good for
- Bootstrap a disposable YDB for development
- Diagnose why a local database is unhealthy
- Apply table DDL to a local deployment
- Harden authentication on a local stack
- Upgrade a stack to a newer image by dump and rebuild
Pricing
Open source
Prices change. Check local-ydb-toolkit.ydb-qdrant.tech before you buy.
Local YDB MCP FAQ
Does it replace the official YDB MCP server?
No. The README calls it complementary: use the official one for general database queries and this one to operate local-ydb stacks.
What does it need?
Node.js 20.19 or newer and, for real operations, Docker or SSH access where local-ydb runs.
Can it change things without confirmation?
Mutating tools return a plan first and execute only when confirm: true is provided.
Where is configuration read from?
LOCAL_YDB_TOOLKIT_CONFIG if set, otherwise local-ydb.config.json in the working directory.
Is Local YDB MCP free?
Yes. Local YDB MCP is open source, so you can use and self-host it for free.
How do I add Local YDB MCP to Claude Code?
Run this command in your terminal: claude mcp add local-ydb-mcp -- npx -y @astandrik/local-ydb-mcp
What are the best alternatives to Local YDB MCP?
The closest alternatives to Local YDB MCP are Midplane, Agent Yurt, Proofline, filex and MagicWP MCP.
Alternatives to Local YDB MCP

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Agent Yurt
MCP serverBack up agent memory, files and dashboards, then recover from a reviewed snapshot
Not checked yet- Remote
- Free
- Knowledge and memory

Proofline
MCP serverProduction-aware review of changes against your AWS or Google Cloud setup, via MCP
- Remote
- Freemium
- Developer tools

filex
MCP serverSelf-hosted file manager in one Go binary with a built-in MCP server for agents
Not checked yet- Remote
- Open source
- Files and documents

MagicWP MCP
MCP serverRun WordPress hosting from an assistant: backups, staging, updates, PHP and domains
- Remote
- Free trial
- Cloud and infrastructure

Kubana Cloud DNS Management
MCP serverCreate DNS zones, edit records and check nameserver delegation on Kubana Cloud
Not checked yet- 5 tools
- Remote
- Free
- Cloud and infrastructure