用途：agent-mongo 是只读 MongoDB CLI，位于 $PATH，用于探索数据库、集合、schema 与索引，以及查询文档（find、按 _id 获取、count、sample、distinct、aggregate）。默认输出 NDJSON，每行一条 JSON 记录；列表命令逐项输出后再输出 @ 前缀元数据行，如 {"@meta": ...}、{"@pagination": ...}。错误以 stderr 单行 JSON 返回，含 error、fixable_by（agent、human、retry）、hint，且退出码非零。
主要能力：连接管理（connection add/list/test/update/set-default/remove，凭据与连接分离存储，优先使用操作系统密钥库，connection list 会脱敏密码）；凭据管理（credential add/list/remove，推荐 --form 原生对话框，或通过管道 stdin 非交互输入；--password 不应用于粘贴到对话中的秘密）；数据库探索（database list、database stats、collection list、collection schema 含 --depth/--limit/--skip、collection indexes、collection stats）；查询（query find 支持 --filter/--sort/--projection、query get、query count、query sample、query distinct）；聚合（query aggregate，支持位置参数、--pipeline 或 stdin，拒绝 $out 与 $merge）；输出格式可用 -f json|jsonl|yaml；截断控制 --full 与 --expand；超时默认 30 秒，可用 -t/--timeout 覆盖，并通过 maxTimeMS 在服务端生效；config 管理默认 limit、sampleSize、timeout、maxDocuments、truncation.maxLength 等；mcp 将 database、collection、query 及 connection list/test 暴露为 MCP 工具，凭据与 config 命令不暴露。
使用方式：先配置连接，例如 agent-mongo connection add local "mongodb://localhost:27017/myapp" --default，再执行 agent-mongo connection test。查询示例：agent-mongo query find myapp users --filter '{"age":{"$gte":21}}' --limit 10。所有 JSON 参数接受 MongoDB Extended JSON 表示 BSON 类型。连接解析顺序为 -c 标志、AGENT_MONGO_CONNECTION 环境变量、配置默认值。每个命令组提供 usage 子命令获取详细文档。
适用场景：代理在用户机器上安全地只读探查 MongoDB 数据结构与数据，配合 MCP 集成到代理工具链。
限制：严格只读，不存在写操作，聚合中的 $out、$merge 被拒绝；结果受 query.maxDocuments 限制（默认 100）；凭据登录若提示 fixable_by: human，必须由用户本人执行，无法由代理绕过；无 GUI 会话时 --form 不可用，可改用管道 stdin；其他未在资料中说明的功能或收费情况暂未提供。