用途:将自然语言描述转换为只读的 MongoDB 查询(find)或聚合管道,并基于集合 schema、索引和样本文档提供上下文,帮助生成可运行、可优化的查询。
主要能力:先通过 MCP 工具获取数据库与集合信息、索引、schema(sampleSize: 50)和样本文档(默认 limit: 4),再校验字段名、判断查询类型。简单过滤、排序、限制、投影优先用 find;需要分组聚合、多阶段转换、$lookup 连接、数组展开时用聚合管道。输出默认使用 MongoDB shell 语法,也可按用户指定的语言或驱动语法输出。
使用方式:按顺序调用 mcp__mongodb__collection-indexes、mcp__mongodb__collection-schema、mcp__mongodb__find 获取上下文;生成查询后检查索引覆盖情况,无合适索引时提示用户。跨客户端:GitHub Copilot 放在可见技能路径或项目指令中;Claude Code 放在本地技能目录或兼容插件源;Codex 安装或同步到 $CODEX_HOME/skills/mongodb-natural-language-querying 并在重大变更后重启。
限制与注意:仅生成只读查询;不使用 $where,不在无文本索引时使用 $text,谨慎使用 $expr;避免冗余操作符;投影只保留所需字段,不需要 _id 时加 _id: 0;数组非空检查用 "arrayField.0": {$exists: true};地理坐标须经度在前。MCP 不可用时使用官方文档、驱动、Atlas UI 或本地只读夹具回退,不得请求或提交连接字符串、密钥;不得在宿主未暴露 MCP 时声称使用了 MCP。无法生成时说明原因、请求澄清或给出替代方案。样本数量按 schema 宽度调整,宽 schema 用投影和 $slice 控制上下文。具体收费、价格、平台支持范围等资料暂未提供。