1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mongodb-natural-language-querying-mongodb-agent-skills（README/SKILL.md 自述名称：“MongoDB Natural Language Querying”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | MongoDB, Inc.（官方，NASDAQ: MDB） | GitHub API（组织账号 mongodb） |
| 来源链接 | https://github.com/mongodb/agent-skills/tree/main/skills/mongodb-natural-language-querying | — |
| 许可证 | Apache-2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 163 / 30（整仓库口径——本技能所在的 mongodb/agent-skills 是 MongoDB 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能热度） |
GitHub API 实测（2026-07-26） |
| 最新版本 | SKILL.md metadata 版本号 1.0.0 | SKILL.md 实测 |
| 安装方式 | Claude Code：/plugin install mongodb；Codex：codex plugin marketplace add mongodb/agent-skills；通用：npx skills add mongodb/agent-skills |
官方 README 实测 |
2. 功能介绍与亮点
MongoDB 官方技能，把“用自然语言操作数据库”这件事系统化为一套可复用的查询生成流程：
- 上下文感知生成：先调用 MCP 工具取目标集合的索引、Schema、样本文档，再生成查询——避免凭空编造字段名导致查询悄无声息返回空结果
- 强制只读：明确限定只生成
find查询与不含写操作的聚合管道，禁止$out/$merge等写入型阶段 - 智能选型：优先选更易读的
find查询，仅在需要分组、多阶段转换、$lookup关联时才升级为聚合管道 - 性能意识：生成查询后主动核对现有索引能否覆盖，命中不了索引会提示用户
- 边界清晰：明确划出不处理的场景（全文/向量检索交给姊妹技能 search-and-ai、性能诊断交给 query-optimizer），避免同包技能之间职责混乱
3. 适用场景
所属分类：数据分析与可视化。面向使用 MongoDB 但不熟悉其查询语法（find/聚合管道）的初中级开发者与数据分析人员：想用大白话筛选、分组、统计 MongoDB 里的数据，或习惯 SQL 语法需要翻译成 MongoDB 写法时使用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方插件市场一条命令 /plugin install mongodb 接入 |
| Codex | 原生支持 | 官方 README 提供 codex plugin marketplace add mongodb/agent-skills 安装步骤 |
| OpenClaw | 未验证 | 官方仅列出 Claude/Cursor/Codex/GitHub Copilot/Grok，未提及 OpenClaw；SKILL.md 遵循开放 Agent Skills 标准格式，理论上可手动复制目录接入，但未查到官方专项说明 |
| Hermes Agent | 未验证 | 已抓取材料未提及 |
5. 推荐理由
MongoDB 官方出品，把“自然语言转 MongoDB 查询”做成了带上下文校验的完整流程：生成前先读真实 Schema 与索引，从源头减少新手写查询时常踩的字段拼错、索引不命中等坑，且严格限定只读，安全边界清晰。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | MongoDB 官方出品（一线数据库厂商）；仓库 163 星（合集整体口径），当前公开渠道未见独立第三方测评或社区讨论 |
| 可用性 | 9 | 官方插件市场一条命令安装；SKILL.md 内容结构清晰，含字段校验、性能优化建议与完整示例 workflow；仓库最近一次推送 2026-07-23，维护活跃；核心功能免费，仅需一次性配置 MongoDB MCP Server |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值（7+9+9）/3 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | allowed-tools 仅声明 mcp__mongodb__*，不含 Bash 或任意 shell 执行权限，且明确限定“只生成只读查询” |
| ② 运行时联网外发 | 无独立联网行为；仅通过用户自行配置的 MongoDB MCP Server 访问用户自己的数据库实例 |
| ③ API Key/凭据 | 技能本身不处理凭据，数据库连接凭据由官方 MongoDB MCP Server 统一管理配置 |
| ④ 可疑指令排查 | SKILL.md 全文未发现 prompt injection 或隐藏指令，内容均为查询生成的最佳实践指导 |
| ⑤ 作者/组织信誉 | MongoDB, Inc.——NASDAQ 上市数据库公司，官方 GitHub 组织账号发布 |
| ⑥ License | Apache-2.0，清晰、完全开源可审计 |
| ⑦ 最近维护 | 仓库最后推送 2026-07-23 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| bigquery-basics（Google 官方） | 面向 Agent 设计的 BigQuery 技能，覆盖权限配置与基础操作规范 | 定位偏“规范与权限入门”，不做自然语言到查询语句的自动翻译；本技能专注“一句话变成一条可执行查询”的生成与校验 |
| database-skills（PlanetScale 官方） | MySQL/PostgreSQL/Vitess 设计调优参考技能 | 提供的是设计与调优参考文档，不涉及具体查询生成，面向 schema/性能层面而非查询语法转换 |
| 同包姊妹技能 mongodb-schema-design / mongodb-query-optimizer | 分别聚焦文档建模、查询性能诊断 | 与本技能互补覆盖“建模—查询生成—性能优化”全链路，功能不重叠 |
核心差异化：现有同类官方数据库技能多聚焦“设计规范”或“性能调优”文档，本技能是其中少见的、把“自然语言生成可执行只读查询”这一初学者高频痛点直接产品化并带上下文校验的技能。
8. 用户评价
该技能目前在第三方平台尚无具名的独立用户评价，公开渠道仅见 MongoDB 官方博客发布公告与官方文档站说明。
9. 其他补充
同一官方合集还包含连接配置、Schema 设计、查询优化、全文与向量检索等技能，共同覆盖 MongoDB 应用开发全生命周期，可按需搭配安装。
10. 安装使用方式
Claude Code（推荐）：
/plugin install mongodb安装后运行 /reload-plugins 激活。
Codex：
codex plugin marketplace add mongodb/agent-skills而后在 /plugins 中找到 “MongoDB Agent Skills” 安装 mongodb 插件。
通用（跨编码助手）：
npx skills add mongodb/agent-skills手动安装： 克隆仓库后将 skills/mongodb-natural-language-querying/ 目录复制到所用编码助手读取 skills 的位置。
无论哪种安装方式，都必须另外配置官方 MongoDB MCP Server（npx "mongodb-mcp-server@latest" setup）才能实际调用——技能本身只提供查询生成逻辑，读取 Schema、索引、执行查询均依赖 MCP Server 连接。
11. 注意事项
- 仓库星数为整个官方技能合集口径，非本技能独立仓库数据
- 必须配合 MongoDB MCP Server 使用，未配置无法工作
- 仅生成只读查询，不处理写操作、Atlas 全文检索、向量检索（分别由其他姊妹技能覆盖）
- OpenClaw、Hermes Agent 支持情况未获验证
- 技能上线时间较短，社区独立讨论与实测案例尚不多