DATABASE DEVELOPMENT / YDB MCP Team
YDB MCP
Python MCP server from the ydb-platform organisation that runs YDB SQL, explains queries, and lists or describes paths, with writes off unless a flag or environment variable turns them on.
“Model Context Protocol server for YDB. It allows to work with YDB databases from any LLM that supports MCP. This integration enables AI-powered database operations and natural language interactions with your YDB instances.”
01 / THE REASONING
Why this made the selection.
- ydb-platform publishes ydb-mcp. At 1ee9df3598abed71ffb83dbdec1375374f89f866, pyproject.toml names version 0.3.0, author YDB MCP Team, requires Python >=3.10, and classifies the package as Development Status :: 3 - Alpha. The script entry is ydb-mcp.
- The README lists ydb_query, ydb_query_with_params, ydb_explain_query, ydb_explain_query_with_params, ydb_list_directory, ydb_describe_path, and ydb_status. It says queries are read-only unless --ydb-allow-write or YDB_ALLOW_WRITE=true is set.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- README.md at 1ee9df3598abed71ffb83dbdec1375374f89f866: opening paragraph, uvx anonymous JSON, pip install line, auth modes, write-query section, tool list.
- pyproject.toml at the same revision: name, version 0.3.0, author, Apache 2.0 text, Alpha classifier, requires-python, script entry.
- LICENSE at the same revision: Apache License 2.0, appendix Copyright 2022-2025 YANDEX LLC.
- ydb_mcp/server.py at the same revision: run() default argument stdio.
Our findings
- publisher in this record is the pyproject author YDB MCP Team. The LICENSE copyright holder is YANDEX LLC.
- pip install ydb-mcp does not pin version 0.3.0. The uvx and pipx examples also omit a version.
- The README says write rejection is done by YDB snapshot read-only transactions, not by SQL text matching in this server.
Not established by this review
- Not executed: it was not installed or run.
- No YDB endpoint was contacted and no auth mode was exercised.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Connect a server deliberately.
DOCUMENTED COMMAND
pip install ydb-mcpCopying does not execute this command. It may retrieve a newer version than the reviewed source.
- The README prints pip install ydb-mcp as a single bash line. It does not pin 0.3.0.
- Or use the printed uvx or pipx client blocks, which also omit a version.
- For a service account, the README says to add the yandexcloud package, which is not installed by default. One printed line is pip install ydb-mcp yandexcloud.
Before you start
- Python >=3.10 and pip, or uvx, or pipx.
- A YDB endpoint and one of the auth modes the README names.
Documented configuration example
Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.
{
"mcpServers": {
"ydb": {
"command": "uvx",
"args": [
"ydb-mcp",
"--ydb-endpoint",
"grpc://localhost:2136",
"--ydb-database",
"/local"
]
}
}
}04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- YDB MCP README at 1ee9df35 ↗Checked
https://github.com/ydb-platform/ydb-mcp/blob/1ee9df3598abed71ffb83dbdec1375374f89f866/README.md
Supports: upstreamDescription, install, configExample, bestFor, limitations, access
https://github.com/ydb-platform/ydb-mcp/blob/1ee9df3598abed71ffb83dbdec1375374f89f866/LICENSE
Supports: license
- pyproject.toml at 1ee9df35 ↗Checked
https://github.com/ydb-platform/ydb-mcp/blob/1ee9df3598abed71ffb83dbdec1375374f89f866/pyproject.toml
Supports: language, compatibility, whySelected
https://github.com/ydb-platform/ydb-mcp/blob/1ee9df3598abed71ffb83dbdec1375374f89f866/ydb_mcp/server.py
Supports: transports, access