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 describeand 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
listruns withoutconfirm. - Mutating actions are plan-only unless
confirm: trueis 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 sqlagainst the configured tenant. - Support a read-only mode for
SELECT,EXPLAIN, and diagnostic queries. - Require
confirm: truefor 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.