Reported issues for Local YDB MCP

Pod holds 10 of 10 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to Local YDB MCP.

Most discussed

Support generation of YDB database schemas using official YDB documentation and @ydb-platform/ydb references

Implement support in local-ydb-mcp for generating valid YDB database schema definitions (DDL) by referencing:

• The official YDB documentation (https://ydb.tech/en/docs/)
• The @ydb-platform/ydb repository to see how yql really works

Requirements:

• Provide commands/utilities to generate new tables, indexes, and other schema objects for YDB databases, producing correct CREATE/ALTER statements.
• Ensure all generated schemas strictly follow the SQL/DDL syntax in the official YDB documentatio

Read the thread · 2026-05-27 · closed · 1 comment

Support creation and application of YDB database schemas via local-ydb-mcp

Add support in local-ydb-mcp to create and apply YDB database schemas (such as table creation, modification, etc.) following the official YDB documentation and using @ydb-platform/ydb to ensure compatibility and valid syntax.

Requirements:

• Implement schema management commands (create table, alter table, etc.) in local-ydb-mcp.
• Ensure all SQL syntax strictly follows the official YDB documentation: https://ydb.tech/en/docs/
• Use @ydb-platform/ydb Node.js package internally for all databa

Read the thread · 2026-05-27 · closed · 1 comment

[Spike] Prove local-ydb async replication and define MCP support

Parent epic: #17

Summary

Investigate and prove whether local-ydb-toolkit can support YDB asynchronous replication for Docker-based local-ydb profiles.

YDB supports async replication between source and target databases through CREATE ASYNC REPLICATION, using CDC changefeeds on the source and replica objects on the target. Before adding MCP tools, we need a local proof that two local-ydb profiles can replicate data over an internal, non-public gRPC connection.

Scope

This is a no

Read the thread · 2026-04-27 · closed · 1 comment

[Task] Expand backup and restore MCP management

Parent epic: #17

Scope

Expand the existing tenant-wide dump/restore tools into a more complete backup and restore management surface.

Current tools: local_ydb_dump_tenant, local_ydb_restore_tenant

Capabilities

• List available dumps under the configured dump host path.
• Support table- or directory-level dump and restore paths instead of only tenant-wide -p ..
• Add optional post-restore verification hooks such as scheme describe and bounded count queries.

Possible impleme

Read the thread · 2026-04-27 · closed · 1 comment

[Task] Add permissions management MCP tool

Parent epic: #17

Scope

Add MCP support for YDB schema permissions management.

Proposed tool: local_ydb_permissions

Capabilities

• List permissions for a schema path.
• Grant, revoke, and set permissions.
• Clear direct permissions.
• Change owner.
• Toggle inheritance where supported by YDB CLI.

Acceptance criteria

• Read-only list runs without confirm.
• Mutating actions are plan-only unless confirm: true is supplied.
• Permission names are passed as structured arguments

Read the thread · 2026-04-27 · closed · 1 comment

[Task] Add schema inspection MCP tool

Parent epic: #17

Scope

Add a read-only schema inspection MCP tool for database-level object discovery.

Proposed tool: local_ydb_scheme

Capabilities

• List schema objects with scheme ls.
• Describe a schema object with scheme describe.
• Default path to the configured tenant root.
• Support recursive listing, long output, and stats where applicable.
• Cap or structure large output so MCP responses stay usable.

Acceptance criteria

• Reuses the existing ydbCli(...) auth/no-a

Read the thread · 2026-04-27 · closed · 1 comment

local_ydb_sql times out on SSH profiles when YDB gRPC is Docker-internal

Summary

local_ydb_sql in @astandrik/local-ydb-mcp@0.15.0 consistently consumes the full timeout and returns Query Service request was cancelled for an authenticated mode: "ssh" profile, even though the same profile passes prerequisites, reports a healthy YDB database, and can execute the same YQL through /ydb sql over SSH.

Both read-only queries and the mandatory EXPLAIN preflight for action: "execute" are affected.

Environment

• MCP package: `@astandrik/local-ydb-mcp@0.15.

Read the thread · 2026-08-04 · closed · 0 comments

[Task] Add principal management MCP tool

Parent epic: #17

Scope

Add MCP support for YDB users and groups management.

Proposed tool: local_ydb_principal

Capabilities

• Create, alter, lock/unlock, and drop users.
• Create and drop groups.
• Add users to groups and remove users from groups.
• Handle passwords with explicit redaction.

Acceptance criteria

• All principal mutations require confirm: true.
• Password values never appear in planned commands, executed command text, stdout, stderr, or test snapshots.
• User/gr

Read the thread · 2026-04-27 · open · 0 comments

Most recent

[Task] Add managed SQL/YQL execution MCP tool

Parent epic: #17

Scope

Add a controlled SQL/YQL execution MCP tool for database-level inspection and managed mutations.

Proposed tool: local_ydb_sql

Capabilities

• Run SQL/YQL through ydb sql against the configured tenant.
• Support a read-only mode for SELECT, EXPLAIN, and diagnostic queries.
• Require confirm: true for DDL/DML or other mutating statements.
• Include timeout and output-size controls.
• Return command, stdout, stderr, exit status, and a clear summary.

Ac

Read the thread · 2026-04-27 · closed · 0 comments

[Epic] Complete the MCP surface for database-level management

Summary

The current MCP server has strong coverage for local-ydb instance and tenant lifecycle management, but it does not yet expose the minimal database-level primitives needed for complete day-to-day database management.

Today we cover Docker/local-ydb lifecycle, tenant creation, dynamic nodes, storage groups, auth hardening, dump/restore, cleanup, and version upgrades. The main gap is safe access to schema, SQL/YQL, ACL, principals, and more granular backup operations.

Goal

Add a

Read the thread · 2026-04-27 · open · 0 comments

The remaining reports are on the project's issue tracker.