Local YDB MCP Server

Operate local-ydb deployments through local or SSH-backed MCP tools.

Local serverstdio

What is the Local YDB MCP MCP server?

Local YDB MCP MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Operate local-ydb deployments through local or SSH-backed MCP tools.

What you get

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

What the assistant can call

Once Local YDB MCP is connected, these are the calls the assistant has available:

  • Checks — The Checks tool exposed by this server
  • Schema — The Schema tool exposed by this server
  • Auth — The Auth tool exposed by this server
  • Storage — The Storage tool exposed by this server
  • Lifecycle — The Lifecycle tool exposed by this server
  • Operations — Read-only tools collect inventory, tenant state, YDB healthcheck/self-check output, schema objects, generated table DDL, schema permissions, node

Setting it up

@astandrik/local-ydb-mcp on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Configuration and credentials

You will need 3 environment variables: LOCAL_YDB_TOOLKIT_CONFIG, LOCAL_YDB_MCP_CONTENT_FORMAT, LOCAL_YDB_MONITORING_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Choosing this one

Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Local YDB MCP's toolset — Checks, Schema, Auth and 3 more — is a fair guide to whether it matches your workflow. It is maintained by astandrik; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the local ydb mcp mcp server does with a few real requests.

Available tools

ToolWhat it does
ChecksThe Checks tool exposed by this server.
SchemaThe Schema tool exposed by this server.
AuthThe Auth tool exposed by this server.
StorageThe Storage tool exposed by this server.
LifecycleThe Lifecycle tool exposed by this server.
OperationsRead-only tools collect inventory, tenant state, YDB healthcheck/self-check output, schema objects, generated table DDL, schema permissions, node state, GraphShard state, auth posture, storage placement, leftover storage

How to install the Local YDB MCP MCP server

{
  "mcpServers": {
    "local-ydb": {
      "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"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
LOCAL_YDB_TOOLKIT_CONFIGConfiguration value read at startup.Optional
LOCAL_YDB_MCP_CONTENT_FORMATConfiguration value read at startup.Optional
LOCAL_YDB_MONITORING_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Local YDB MCP to Checks.
  • Use Local YDB MCP to Schema.
  • Use Local YDB MCP to Auth.

Frequently asked questions

It connects Local YDB MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (Checks, Schema, Auth, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Local YDB MCP directly.