用途：面向需要操作 Docker 版 local-ydb 环境的智能体，提供主机前置检查、根库或租户引导、动态节点生命周期、GraphShard 检查、表 DDL 生成/校验/应用、认证加固、存储工作流、dump/restore 与版本升级等能力。与官方 ydb/ydb-mcp 互补：后者用于通用数据库级工具（临时 SQL、查询解释、目录与路径检查），本工具包用于操作 local-ydb 环境本身。
主要能力：仓库包含可复用的 Codex 技能、以 @astandrik/local-ydb-mcp 发布的非官方本地 stdio MCP 服务器（暴露 39 个工具），以及 GitHub Actions 动作 astandrik/setup-local-ydb，用于在 CI 中启动一次性 YDB 租户。只读工具可收集清单、租户状态、健康检查、schema 对象、DDL、权限、节点与 GraphShard 状态、认证态势、存储放置、镜像标签等。变更类工具默认仅生成计划，需 confirm: true 才执行。
使用方式：MCP 启动器要求 Node.js 20.19 或更高版本及 npx。可通过 Codex 安装技能，或使用 npm 包直接接入 MCP 客户端，也可全局安装。基于 profile 的调用需使用绝对 configPath，或设置 LOCAL_YDB_TOOLKIT_CONFIG 为绝对路径；显式路径必须指向不超过 1 MiB 的可读常规 JSON 文件，缺失或无效会失败关闭。配置示例见 examples/local-ydb.config.example.json。profile 支持 mode: "local" 或 mode: "ssh"（通过 ssh -o BatchMode=yes -o ConnectTimeout=10 执行）。租户 profile 可设 dynamicNodeCount（默认 1，范围 1..11）。
适用场景与限制：适用于本地 Docker 主机或 SSH 远程的 local-ydb 运维、CI 中临时租户测试、认证加固与存储维护。SSH 使用现有 SSH agent/key/known_hosts，不存储 SSH 密码。Linux Docker Engine 下 SDK 类工具可经 SSH 隧道访问 Docker 内部 gRPC 端口；Docker Desktop 与 rootless Docker 回退路径不受支持。公开 OpenAI 提交物仅含技能，因公开 MCP 提交需生产 HTTPS MCP 服务器。Claude 社区提交与 Gemini 扩展画廊收录状态以官方目录为准。
