Official YDB MCP server

YDB MCP

YDB's own official MCP server from the database's developers: parameterized SQL queries, execution plans, directory browsing, and a base for custom servers

  • 29 ★ on the repository
  • Last commit
  • Apache-2.0
MCP serverOfficialEditors’ pick

Broad access

Why this level

  • By default the server only reads, but with the --ydb-allow-write flag it executes arbitrary SQL, including data changes and deletions
  • Token or service account authentication grants broad database access unless the key's rights are restricted
All reasons and checks
Russian stack

ydb-platform/ydb-mcp

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/ydb-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • By default the server only reads, but with the --ydb-allow-write flag it executes arbitrary SQL, including data changes and deletions
  • Token or service account authentication grants broad database access unless the key's rights are restricted

This is third-party code. Review the repository files before installing.

What it does

The server gives an agent seven tools for the YDB distributed database: running a SQL query, running a parameterized query with JSON parameters, getting the execution plan for a plain or parameterized query, listing directory contents, describing a path in detail (tables, directories) and checking the connection status. It supports anonymous authentication, login/password, an access token, and Yandex Cloud service account authentication via the yandexcloud package. The YDBMCPServer class is designed to be subclassed: you can add your own tools on top of an established connection and disable the generic tools so the model only sees a fixed set of queries matching your business logic instead of arbitrary database access.

Who it is for. For developers and data engineers working with YDB who want to run queries and inspect the schema through an agent.

Good fit when

  • You want an official YDB MCP server maintained by its developers, not a third-party wrapper
  • You want a query's execution plan before running it against a production database
  • You want to restrict the agent to a fixed set of safe queries via your own server subclass

Not a fit when

  • You need protection from arbitrary SQL with writes enabled: with the --ydb-allow-write flag the server executes any query it is sent
  • You are working with a different database, not YDB

Example request

Show the execution plan for this YDB query and list the tables in the /local/orders directory

MCP

Transport
stdio
Authentication
API key

Limitations

By default the server is read-only: queries run in YDB snapshot transactions, and writes are enabled with the --ydb-allow-write flag or YDB_ALLOW_WRITE=true. With writes enabled the server executes arbitrary SQL, so narrow the toolset via subclassing. Yandex Cloud service account authentication requires the extra yandexcloud package. It needs a reachable YDB grpc endpoint, local or cloud.

How to disable. Remove the ydb block from your MCP client config.

FAQ

Can the agent be restricted to read-only access?

Yes, by subclassing YDBMCPServer, disabling the generic tools and adding your own with a limited set of queries.

Which authentication methods are supported?

Anonymous access, login/password, an access token and a Yandex Cloud service account.

Discussion

No questions or reviews yet.

Official

An official long-term memory MCP server for agents on YDB Serverless: mem0 extracts facts, YDB stores the vectors

MCP serverExtended access2Repository stars

YDB MCP connection demo built on a notes app

Simple CLI Notes Application with YDB

Official

An official YDB example: docker compose brings up a YDB database and the ydb-mcp server, and Cursor runs SQL through them right from chat

MCP serverExtended access
Russian stack

A skill and MCP server for operating Docker-based local-ydb deployments: nodes, schema, dump and restore, locally or over SSH

PluginExtended access5Repository stars

One MCP server for SQLite, SQL Server, PostgreSQL and MySQL: read and change data, edit schemas and export to CSV and JSON

MCP serverBroad access391Repository stars
Official

A single-binary MCP server for MySQL, MariaDB, PostgreSQL and SQLite: read-only by default, with optional PII redaction

MCP serverBroad access33Repository stars

A Python MCP server for MySQL: listing tables, reading data, running SQL and inspecting schema through a controlled interface

MCP serverBroad access1.4KRepository stars

README in short

The README describes YDB MCP as the official server for working with YDB databases from any MCP-capable LLM. It shows three install and run methods (uvx, pipx, pip), configuration examples for anonymous access, login/password, an access token and a Yandex Cloud service account, a list of seven tools, and a separate section on building custom MCP servers on top of the YDBMCPServer class, disabling generic tools for security and domain specificity.

README badge

Report a problem