MCP Directory

YDB MCP

Query and explore YDB databases from any MCP-compatible LLM using natural language.

Unverified
stdio (local)
API key
Python
View repo 27 Website

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run
pip install ydb-mcp

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ydb-mcp": {
      "command": "uvx",
      "args": [
        "ydb-mcp",
        "--ydb-endpoint",
        "grpc://localhost:2136",
        "--ydb-database",
        "/local"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

  • A reachable YDB endpoint and database (e.g. grpc://localhost:2136 with database /local)
  • Python 3 with one of uvx (uv), pipx, or pip available to launch the server
  • Valid YDB credentials for the chosen auth mode (login/password, access token, or service-account key file); the yandexcloud package is also required for service-account auth

About YDB MCP

Official MCP server from the YDB platform team that enables AI-powered, natural-language interaction with YDB databases. It exposes tools for executing (parameterized) SQL queries, explaining query plans, listing directories, and describing paths, and supports anonymous, login/password, access-token, and service-account authentication. Run it via uvx, pipx, or pip, and optionally subclass YDBMCPServer to add custom tools or lock down which generic tools are available.

Tools & capabilities (7)

ydb_query

Run a SQL query against a YDB database. Parameter: sql (SQL query string to execute).

ydb_query_with_params

Run a parameterized SQL query with JSON parameters. Parameters: sql (query with placeholders), params (JSON string of parameter values).

ydb_explain_query

Explain a SQL query, returning the execution plan. Parameter: sql (SQL query string to explain).

ydb_explain_query_with_params

Explain a parameterized SQL query. Parameters: sql (query with placeholders), params (JSON string of parameter values).

ydb_list_directory

List directory contents in YDB. Parameter: path (YDB directory path to list).

ydb_describe_path

Get detailed information about a YDB path such as a table or directory. Parameter: path (YDB path to describe).

ydb_status

Get the current status of the YDB connection.

What this server can do

YDB MCP provides tools for these capabilities — tap one to see every MCP server that does the same:

Inspect database schema

When to use it

  • Querying and exploring YDB data through natural language in an MCP-enabled LLM client
  • Inspecting query execution plans to debug or optimize YDB SQL
  • Browsing the YDB directory tree and describing tables/paths during development
  • Building a custom, locked-down MCP server that exposes only specific read-only queries by subclassing YDBMCPServer

Security notes

The ydb_query and ydb_query_with_params tools execute arbitrary SQL against the connected YDB database, so the configured credentials should be scoped to the minimum privileges needed. Credentials (login/password, access token, or service-account key file) are passed as command-line arguments in the MCP client config; access-token and password values appear in plaintext in that config. For restricted deployments, subclass YDBMCPServer to disable generic tools and expose only fixed, read-only queries.

YDB MCP FAQ

How do I run YDB MCP without installing it?

Use uvx (an alias for uv run tool) or pipx run, pointing the command at ydb-mcp with --ydb-endpoint and --ydb-database arguments. Both let you launch the server without a persistent install.

Which authentication modes are supported?

Anonymous (default), login/password (--ydb-auth-mode login-password with --ydb-login/--ydb-password), access token (--ydb-auth-mode access-token with --ydb-access-token), and Yandex Cloud service account (--ydb-auth-mode service-account with --ydb-sa-key-file, which also requires the yandexcloud package).

Can I limit which tools the model can use?

Yes. Subclass YDBMCPServer and set the generic_tools class attribute to a subset of the YDBGenericTool enum (or an empty set), then register your own @self.tool() functions. This lets you expose only fixed, read-only queries instead of arbitrary SQL execution.

#ydb#database#sql#yandex#distributed-database#python

Alternatives to YDB MCP

Compare all alternatives →
MCP Toolbox for Databases (BigQuery)
Databases
16k

Google's official MCP server with prebuilt BigQuery tools, querying datasets via Application Default Credentials.

Verified
stdio (local)
OAuth
Go
10 tools
Updated 23 days agoRepo
InstantDB MCP
Databases
10k

Create, manage, and query your InstantDB apps, schemas, permissions, and data from your AI editor.

Unverified
HTTP (remote)
OAuth
TypeScript
7 tools
Updated 1 day agoRepo
DBHub
Databases
3.0k

Zero-dependency, token-efficient database MCP server for Postgres, MySQL, SQL Server, MariaDB, and SQLite.

Unverified
stdio (local)
No auth
TypeScript
3 tools
Updated 1 day agoRepo

Compare YDB MCP with:

vs MCP Toolbox for Databases (BigQuery)vs InstantDB MCPvs DBHubvs Postgres MCP Pro