Local YDB MCP

An unofficial MCP server for operating Docker-based local-ydb deployments.

It allows MCP-compatible agents to:

• bootstrap root databases and tenant topologies;
• diagnose local YDB health and container state;
• manage dynamic nodes and storage groups;
• generate, validate, and apply YDB table schemas;
• configure authentication and permissions;
• perform dump and restore operations;
• upgrade local YDB versions.

Mutating operations are plan-first and require explicit confirm: true before execution.

Requirements

• Node.js 20.19 or newer
• Docker
• An MCP-compatible client

Configuration

{
  "mcpServers": {
    "local-ydb": {
      "command": "npx",
      "args": [
        "-y",
        "--prefer-online",
        "@astandrik/local-ydb-mcp@latest"
      ]
    }
  }
}

By default, the server uses a local profile. To use a custom configuration file:

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

Security

This server operates on the user's local Docker environment or an explicitly configured SSH target.

Read-only tools execute directly. Mutating tools first return a plan and only perform changes when called with confirm: true.

Passwords, credential files, and sensitive host paths are redacted where applicable.

Links

• Source code: https://github.com/astandrik/local-ydb-toolkit
• Documentation: https://local-ydb-toolkit.ydb-qdrant.tech/
• npm: @astandrik/local-ydb-mcp
• Official MCP Registry name: io.github.astandrik/local-ydb-mcp