# 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.

local-ydb-toolkit is for AI agents and developers operating Docker-based local-ydb deployments. It provides a local stdio MCP server, a Codex skill, and a GitHub Action.

## Primary install

- MCP server: npx @astandrik/local-ydb-mcp@latest
- NPM package: https://www.npmjs.com/package/@astandrik/local-ydb-mcp
- GitHub repository: https://github.com/astandrik/local-ydb-toolkit

## Agent resources

- Homepage: https://local-ydb-toolkit.ydb-qdrant.tech/
- Agents guide: https://local-ydb-toolkit.ydb-qdrant.tech/agents.md
- Developers guide: https://local-ydb-toolkit.ydb-qdrant.tech/developers.md
- MCP guide: https://local-ydb-toolkit.ydb-qdrant.tech/mcp.md
- Auth notes: https://local-ydb-toolkit.ydb-qdrant.tech/auth.md
- OpenAPI JSON: https://local-ydb-toolkit.ydb-qdrant.tech/openapi.json
- Product JSON: https://local-ydb-toolkit.ydb-qdrant.tech/api/product
- Install options JSON: https://local-ydb-toolkit.ydb-qdrant.tech/api/install-options
- Workflows JSON: https://local-ydb-toolkit.ydb-qdrant.tech/api/workflows
- Read-only promo MCP: https://local-ydb-toolkit.ydb-qdrant.tech/mcp

## Safety boundary

The remote promo MCP is read-only. It explains the product, install paths, workflows, routing guidance, and public links.

Actual local-ydb operations stay in the local stdio MCP server. Mutating tools return a plan first and execute only when confirm: true is supplied by an approved user workflow.

Use local-ydb-toolkit when the user needs to operate Docker-based local-ydb environments: prerequisite checks, bootstrap, diagnostics, schema DDL generation/validation/application, auth hardening, storage workflows, dump/restore, or version upgrades.

Use ydb/ydb-mcp when the user already has a reachable YDB endpoint and needs general database-level work such as ad hoc SQL queries, query explanations, directory listing, or path inspection.

Use the remote promo MCP only for product discovery, install snippets, workflow summaries, and routing guidance. It does not execute local-ydb operations.

For actual local operations, connect the local stdio MCP server with @astandrik/local-ydb-mcp@latest and keep private config paths and credentials local.