1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mongodb-search-and-ai-mongodb-agent-skills（SKILL.md 自述名称：“mongodb-search-and-ai”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | MongoDB, Inc.（官方，NASDAQ: MDB） | GitHub API（组织账号 mongodb） |
| 来源链接 | https://github.com/mongodb/agent-skills/tree/main/skills/mongodb-search-and-ai | — |
| 许可证 | Apache-2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 165 / 29（整仓库口径——本技能所在的 mongodb/agent-skills 是 MongoDB 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能热度；该技能自身在 skills.sh 上有 2.9K 次独立安装记录，见第 6 章） |
GitHub API 实测（2026-08-04）；skills.sh 实测 |
| 最新版本 | SKILL.md metadata 版本号 1.0.0 | SKILL.md 实测 |
| 安装方式 | Claude Code：/plugin install mongodb-atlas；Codex：codex plugin marketplace add mongodb/agent-skills；通用：npx skills add mongodb/agent-skills |
官方 README 实测 |
2. 功能介绍与亮点
MongoDB 官方技能，把“该用哪种检索方式、怎么建索引、怎么写查询”这套原本要翻文档才能搞懂的决策系统化：
- 三选一决策流程：先厘清用户需求（关键词匹配、模糊容错、语义相似、RAG 检索、还是混合场景），再引导到全文检索（Atlas Search）、向量检索（Vector Search）或混合检索（Hybrid Search，用
$rankFusion/$scoreFusion合并管道）三条路径之一 - 先探测环境再建议：动手前先用 MCP 工具核对现有索引与 Schema，避免凭空建议一份跟实际集合对不上的索引配置
- 版本感知：混合检索前会先核对集群版本（
$rankFusion需 8.0+，$scoreFusion需 8.2+），版本不满足就明确告知用户升级而非硬着头皮生成会报错的查询 - 明确反模式：文档直接点名“不要用
$regex或$text做搜索场景”，并解释原因（缺相关性排序、缺模糊匹配、扩展性差），把新手最容易踩的坑写进了技能本身 - 写操作需人工确认：创建索引前要求先展示 JSON 配置、征得用户明确同意才调用创建工具；只读模式下则直接把配置交给用户自行在 Atlas UI 里创建
3. 适用场景
所属分类：数据分析与可视化。面向已经在用 MongoDB、需要给应用加上搜索或检索能力的初中级开发者：想做站内全文搜索、模糊匹配、自动补全，或是要给 RAG/语义检索应用接入向量库又不想额外引入一个独立向量数据库时使用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方 Claude 插件市场一条命令 /plugin install mongodb-atlas 接入，随附 /reload-plugins 激活步骤 |
| Codex | 原生支持 | 官方 README 提供 codex plugin marketplace add mongodb/agent-skills 安装步骤，并说明遵循 agentskills.io 开放标准 |
| OpenClaw | 未验证 | 官方仅列出 Claude、Cursor、Codex、GitHub Copilot（CLI/VS Code）、Grok 五家；SKILL.md 本身是标准格式，理论上可手动复制目录接入，但未查到官方专项说明 |
| Hermes Agent | 未验证 | 已抓取材料未提及 |
5. 推荐理由
MongoDB 官方出品，把“该用全文检索还是向量检索”这个新手常答错的判断题，变成了一套先探测环境、再给出经过版本校验的索引与查询方案的完整流程，并把“别用 regex/text 做搜索”这类容易踩的坑直接写进技能规则；已被第三方实测验证能让 Agent 从默认使用 regex 纠正为正确调用 Atlas Search。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | MongoDB 官方出品（一线数据库厂商）；技能自身在 skills.sh 安装目录有 2.9K 次独立安装记录；另有 MongoDB 官方博客公告与至少一篇独立作者（数据库公司解决方案架构师）的实测评测文章，多来源均可查证 |
| 可用性 | 9 | 官方插件市场一条命令安装，覆盖 Claude/Cursor/Codex/Copilot/VS Code/Grok 六个渠道；托管版走 OAuth 免手工存凭据；SKILL.md 与四份专项参考文档（全文索引/全文查询/向量检索/混合检索）内容详尽；仓库近日仍有推送，维护活跃 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值（7+9+8）/3 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 不直接执行 shell 命令，全部动作通过 MongoDB MCP Server 提供的受限工具（如 list-databases、collection-schema、create-index、aggregate）完成；创建索引等写操作要求先展示配置、征得用户明确同意后才执行 |
| ② 运行时联网外发 | 仅通过用户自行配置的 MongoDB MCP Server 连接用户自己的 MongoDB/Atlas 实例，无其他联网行为 |
| ③ API Key/凭据 | 托管版（mongodb-atlas 插件）走浏览器 OAuth 登录，技能本身不接触也不存储凭据；自管版由官方 MCP Server 统一管理连接字符串 |
| ④ 可疑指令排查 | SKILL.md 与四份参考文档全文均为检索方案选型与查询/索引编写指导，未发现 prompt injection 或隐藏指令 |
| ⑤ 作者/组织信誉 | MongoDB, Inc.——NASDAQ 上市数据库公司，官方 GitHub 组织账号发布，仓库另配有 CodeQL 与技能校验 CI 工作流 |
| ⑥ License | Apache-2.0，清晰、完全开源可审计 |
| ⑦ 最近维护 | 仓库最后推送 2026-08-02 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| redis-search-redis-agent-skills（Redis 官方） | 覆盖 Redis 全文与向量检索的索引设计、查询命令与 RAG 最佳实践 | 同属“通用数据库官方出品的检索技能”，服务对象已经在用 Redis；本技能服务对象是已经在用 MongoDB、不想为搜索另外引入新存储的团队 |
| chroma-local / chroma-cloud（Chroma 官方） | Chroma 是专用向量数据库，local 版零账号零费用本机跑语义搜索，cloud 版覆盖多索引与云端专属能力（如 Collection Forking） | 面向愿意为检索单独引入一个专用向量库的团队；本技能面向已有 MongoDB 数据、想直接在原有数据库里加检索能力、不想多维护一套存储的团队 |
| qdrant-search-quality（Qdrant 官方） | 诊断 Qdrant 向量检索结果不相关或质量下降的问题 | 定位是检索上线后的质量排障，而非索引与查询的从零搭建；本技能覆盖的是选型与搭建阶段 |
核心差异化：多数官方检索类技能要么服务专用向量数据库、要么聚焦上线后的质量诊断；本技能的差异点在于服务“数据本来就在 MongoDB 里”的团队，把全文、向量、混合三种检索方式的选型与实现整合进同一个数据库技能里，省去额外引入新存储的成本。
8. 用户评价
一位数据库行业解决方案架构师在 Medium 发表的独立测评文章中，对比了启用与未启用本技能时 Agent 的检索方案选择：未启用时 Agent 对搜索类需求默认生成 $regex 查询，作者评价“不算错但也不是最优解”；启用后 Agent 正确改用 Atlas Search。作者总结：“给 LLM 的指令质量和它使用的工具质量同样重要。”
9. 其他补充
同一官方合集还包含连接配置、Schema 设计、自然语言查询、查询优化、MCP 接入向导等技能，共同覆盖 MongoDB 应用开发全生命周期，可按需搭配安装。
10. 安装使用方式
Claude Code（托管 Atlas，推荐）：
/plugin install mongodb-atlas安装后按提示完成浏览器 OAuth 登录，运行 /reload-plugins 激活。
自管部署（MongoDB Community / Enterprise Advanced / 自托管）：
/plugin install mongodb该插件在本地通过 npx 启动 MongoDB MCP Server，连接到用户自行指定的连接字符串。
Codex：
codex plugin marketplace add mongodb/agent-skills而后在插件浏览器中安装 mongodb-atlas 或 mongodb 插件。
通用（跨编码助手）：
npx skills add mongodb/agent-skills手动安装： 克隆仓库后将 skills/mongodb-search-and-ai/ 目录（含 SKILL.md 与 references/ 参考文档）复制到所用编码助手读取 skills 的位置。
无论哪种安装方式，都必须另外配置 MongoDB MCP Server 才能实际调用——技能本身只提供检索方案选型与查询/索引编写逻辑，探测 Schema、创建索引、执行查询均依赖 MCP Server 连接到真实数据库实例。
11. 注意事项
- 仓库星数为整个官方技能合集口径，非本技能独立仓库数据；技能自身热度以 skills.sh 2.9K 次安装量为准
- 必须配合 MongoDB MCP Server 使用，未配置无法工作
- 混合检索（
$rankFusion/$scoreFusion）对 MongoDB 集群版本有硬性要求（分别需 8.0+ / 8.2+），版本不满足时该功能不可用 - OpenClaw、Hermes Agent 支持情况未获验证