# local-ydb-toolkit

Docker-based local-ydb operations for AI agents, with plan-first MCP tools, a reusable Codex skill, and a GitHub Action for disposable YDB in CI.

## Quickstart

```bash
npx @astandrik/local-ydb-mcp@latest
curl -s https://local-ydb-toolkit.ydb-qdrant.tech/api/product
curl -s https://local-ydb-toolkit.ydb-qdrant.tech/openapi.json
```

## Why local-ydb-toolkit

local-ydb-toolkit is focused on local database deployment automation for Docker-based YDB. Unlike one-off shell scripts, mutating workflows return a plan first and require `confirm: true` before execution. Unlike general database query MCP servers, it operates the local-ydb stack itself.

## Key resources

- [Agents guide](https://local-ydb-toolkit.ydb-qdrant.tech/agents.md)
- [API docs](https://local-ydb-toolkit.ydb-qdrant.tech/docs/api)
- [Auth guide](https://local-ydb-toolkit.ydb-qdrant.tech/auth.md)
- [MCP guide](https://local-ydb-toolkit.ydb-qdrant.tech/mcp.md)
- [Comparison guide](https://local-ydb-toolkit.ydb-qdrant.tech/compare)
- [Guides index](https://local-ydb-toolkit.ydb-qdrant.tech/guides)
- [CI guide](https://local-ydb-toolkit.ydb-qdrant.tech/guides/local-ydb-ci)

## Directory and trust listings

- [Official MCP Registry](https://registry.modelcontextprotocol.io/?q=io.github.astandrik%2Flocal-ydb-mcp) - registry; official metadata. Model Context Protocol registry search for the published server name.
- [CuratedMCP](https://www.curatedmcp.com/marketplace/local-ydb-unofficial-mcp-server) - trust; verified listing. Curated marketplace profile for the local YDB MCP server.
- [Glama](https://glama.ai/mcp/servers/astandrik/local-ydb-toolkit) - trust; indexed score. MCP server listing with score and discovery metadata.
- [wmcp.sh](https://wmcp.sh/mcp/grade/npm%3A%40astandrik%2Flocal-ydb-mcp) - trust; grade page. Public grade page for the npm MCP package.
- [MCP Sentinel](https://mcp-sentinelweb-production.up.railway.app/servers/astandrik-local-ydb-mcp) - audit; audit page. Security-oriented directory entry for the MCP server.
- [Enterprise DNA](https://enterprisedna.co/directories/mcp/astandrik-local-ydb-toolkit/) - directory; listed. Enterprise DNA MCP directory page for local-ydb-toolkit.
- [MCP.so](https://mcp.so/server/local-ydb-mcp/astandrik) - directory; listed. MCP.so server entry for the local-ydb-mcp package.
- [MCP Toplist](https://mcptoplist.com/server/io.github.astandrik%2Flocal-ydb-mcp) - directory; listed. MCP Toplist profile for the official server identifier.
- [Claude Code Marketplaces](https://claudemarketplaces.com/mcp/io.github.astandrik/local-ydb-mcp) - directory; listed. Claude-focused MCP marketplace entry for the server.
- [LobeHub](https://lobehub.com/mcp/astandrik-local-ydb-toolkit) - directory; listed. LobeHub MCP directory entry for agent discovery.
- [CodeGuilds](https://codeguilds.dev/packages/local-ydb-toolkit) - directory; listed. Package listing for local-ydb-toolkit developer discovery.
- [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers#databases) - directory; awesome list. Awesome MCP Servers database category listing.
- [Awesome Skills](https://www.awesomeskills.dev/en/skill/astandrik-local-ydb-toolkit) - directory; skill listing. Codex skill directory page for the local-ydb skill.
- [Skiln](https://skiln.co/mcp/mcp-io-github-astandrik-local-ydb-mcp) - directory; listed. MCP catalog entry for the io.github server name.
- [PolicyLayer](https://policylayer.com/tools/local-ydb) - governance; policy catalog. Policy and token-cost catalog page for the MCP server.
- [Timeahead MCPScore](https://timeahead.in/mcp/local-ydb-mcp) - directory; listed. MCPScore directory listing for the local-ydb-mcp package.

## Capabilities

- Diagnostics: Inventory containers, inspect tenant status, run YDB healthcheck, read logs, and route follow-up checks by issue type.
- Bootstrap: Start a root /local database or a tenant-oriented topology when GraphShard, storage workflows, or dynamic nodes are required.
- Schema: Generate strict YDB table DDL, validate it through the official SDK, and apply only after explicit confirmation.
- Auth hardening: Prepare native auth config, write dynamic-node auth artifacts, apply hardening, and verify anonymous access is closed.
- Storage: Inspect storage pool placement, add groups, reduce groups by dump/rebuild/restore, and clean leftovers only after review.
- Backup/restore: List available dumps, dump tenant-relative paths, and restore with optional scheme and bounded count-query verification.
- Version upgrades: Discover image tags, pull images in the background, and upgrade by dump, rebuild, restore, auth reapply, and verification.