用途:通过保存的本地 MongoDB 连接配置文件,安全地查看和修改 MongoDB 文档。该技能使用 Bash 脚本与 mongosh,不依赖 Python 或 jq。
主要能力:保存可复用的 MongoDB 连接配置;直连、SSH 隧道连接私有 MongoDB 主机、以及服务器上已存在 MONGODB_URI(如远程 .env 文件)时的 SSH 远程执行;支持 ping、列数据库、列集合、find、count、insert、update、delete 和受保护的原始 MongoDB JavaScript。输出 JSON 到 stdout,默认同时保存到 ./out/mongodb-crud-<UTC时间戳>-<pid>.json。
使用方式:配置保存在 ~/.config/mongodb-crud/profiles/<profile>.conf,默认配置名存于 ~/.config/mongodb-crud/default_profile。示例:bash <skill-path>/scripts/mongodb_crud.sh configure --profile local --mode direct --uri "mongodb://user:password@127.0.0.1:27017/app?authSource=admin" --database app --default。可用 list-profiles 查看脱敏配置,remove-profile 删除。读操作包括 ping、databases、collections、find、count;写操作默认 dry-run,需在用户明确确认后加 --execute 才真正执行;raw-eval 写操作需同时加 --execute 和 --allow-raw-write。过滤、文档、更新、投影和排序以 JSON 或 MongoDB Extended JSON 字符串传入。
适用场景:本地或可直接访问的 MongoDB 用 direct;MongoDB 私有但命令需经本地 mongosh 运行用 ssh-tunnel;服务器已知道 MONGODB_URI 的生产式访问用 ssh-remote。
限制:切勿在本仓库保存 MongoDB 凭据;不要打印密码或完整 URI;readonly 配置不得用于写命令;优先使用结构化命令而非 raw-eval;该技能不是 MongoDB 迁移或备份工具,除非用户明确要求并确认风险,不应执行大范围破坏性操作。