SkillFoxx

Local YDB deployment toolkit plugin

local-ydb-toolkit

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

  • 5 ★ on the repository
  • Last commit
  • MIT
Plugin

Extended access

Why this level

  • Can start and stop Docker containers and YDB nodes on the host
  • Mutating tools apply DDL and data restore after a confirm: true
All reasons and checks
Russian stack

astandrik/local-ydb-toolkitAuthor:astandrik

Install

Services

Manual install

codex plugin marketplace add astandrik/local-ydb-toolkit --ref main && codex plugin add local-ydb-toolkit@local-ydb-toolkit

The main install path for Codex; a new session is required after install.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Can start and stop Docker containers and YDB nodes on the host
  • Mutating tools apply DDL and data restore after a confirm: true

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

What it does

The toolkit complements the official ydb-platform/ydb-mcp server, which gives general database-level tools like ad hoc SQL queries. This project handles a different job: operating the local-ydb Docker deployment itself, locally or over SSH. Its tools check host prerequisites, bootstrap root and tenant databases, manage dynamic node lifecycle, check GraphShard, generate, validate and apply table DDL, harden auth, handle storage, and run dump and restore. The local_ydb_sql tool is deliberately narrower than the official server's general SQL tool: it runs only managed YQL against the selected local profile. Mutating tools show a plan first and require confirm: true before executing. It publishes as the @astandrik/local-ydb-mcp npm package and as an Agent Plugin for Codex, Claude Code and Gemini CLI.

Who it is for. For developers running local or SSH-based YDB deployments for development and CI who want to manage their lifecycle through an agent.

Good fit when

  • You need to bring up or check a local-ydb Docker deployment before development
  • You need to generate and apply table DDL for a local YDB
  • You need an ephemeral YDB tenant in GitHub Actions via the companion setup-local-ydb action

Not a fit when

  • You need general access to a production or cloud YDB with ad hoc SQL: the official ydb-platform/ydb-mcp fits that better
  • You cannot let the agent run Docker commands on the host: that is exactly what the toolkit does

Example request

Check host prerequisites for local-ydb, bring up the tenant database and dump the schema before a migration

Limitations

The MCP server needs Node.js 20.19 or newer plus npx, and its first start reaches out to the npm registry for the @astandrik/local-ydb-mcp package. Publication to the Claude Community plugin catalog and the Gemini extension gallery was not yet complete at review time; direct install from the repository already works. The README explicitly calls external scores like VerifyMCP and glama directory snapshots, not security attestations.

How to disable. Remove the plugin with codex plugin remove, or delete the .mcp.json config and the skills/local-ydb folder.

FAQ

How is this different from the official ydb-platform/ydb-mcp?

The official server gives general database-level tools like ad hoc SQL against an existing YDB endpoint, while this toolkit operates the local-ydb Docker deployment itself: nodes, DDL, dump and restore.

Do the tools change data without confirmation?

No, mutating tools show the operation's plan first and only run after an explicit confirm: true.

Discussion

No questions or reviews yet.

All YDB tools

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
Official

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

MCP serverBroad access29
Official

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

MCP serverExtended access2
Russian stack

An offline MCP server with full-text search over a local copy of the Yandex Cloud docs: no network, read-only, line-numbered citations

MCP serverMinimal access
Official

The docker mcp CLI plugin and gateway: MCP servers from Docker's catalog in isolated containers behind one connection point

MCP serverBroad access1.6K
Official

Yandex Cloud's official MCP server set: documentation, search, app deployment, serverless functions, containers and a data catalog

MCP serverBroad access49

README in short

The English README has a dedicated Relationship to ydb/ydb-mcp section drawing the line with the official server, describes three install surfaces, an Agent Plugin for Codex, a Claude Code plugin and a Gemini CLI extension, plus the setup-local-ydb GitHub Action, and details the absolute-config-path requirements and the confirmation rule for mutating tools.

README badge

Report a problem