1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | mongodb-connection-mongodb-agent-skills（README/SKILL.md 自述名称：“MongoDB Connection Optimizer”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | MongoDB, Inc.（官方，NASDAQ: MDB） | GitHub API（组织账号 mongodb） |
| 来源链接 | https://github.com/mongodb/agent-skills/tree/main/skills/mongodb-connection | — |
| 许可证 | Apache-2.0 | GitHub API 实测 + SKILL.md front matter 双重确认 |
| GitHub Stars / Forks | 163 / 30（整仓库口径——本技能所在的 mongodb/agent-skills 是 MongoDB 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能热度） |
GitHub API 实测（2026-07-25） |
| 最新版本 | 本技能 SKILL.md 内部版本号 1.0.0 | SKILL.md metadata 字段实测 |
| 安装方式 | Claude Code：/plugin install mongodb-atlas 或 /plugin install mongodb；通用：npx skills add mongodb/agent-skills，或克隆仓库后手动复制 skills/mongodb-connection/ 目录 |
官方 README 实测 |
2. 功能介绍与亮点
MongoDB 官方技能，专注解决一个高频问题：跨语言驱动的连接池与超时参数怎么配。它把配置过程做成先问后答的诊断流程：
- 先问环境再给参数：先问部署形态、并发量、驱动语言，再给建议并解释依据，不凭空加参数
- 覆盖官方全部驱动语言：Node.js、Python、Java、Go、C#、Ruby、PHP 等，同步/异步驱动的设计差异也讲清
- 给出可计算的容量公式：按吞吐量估算
poolSize、按副本集成员数估算监控连接开销，而非“调大试试” - 配套故障诊断参考：
references/monitoring-guide.md列出连接池生命周期事件与健康/异常模式，供排查超时、池耗尽时查阅 - 无外部依赖：纯知识型技能，不需连接 MCP Server 或数据库账号，安装即可用
3. 适用场景
所属分类：工程效率与代码质量
适合用 MongoDB 官方驱动开发的初中级开发者：新写连接初始化代码、给 Serverless 函数配置连接、优化高并发下的连接池参数，或排查 ECONNREFUSED、超时、池耗尽等报错时使用。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方插件市场一条命令 /plugin install mongodb-atlas（或自管部署版 mongodb）接入，且技能本身为标准 SKILL.md 格式，也可直接复制目录使用 |
| Codex | 原生支持 | README 提供 codex plugin marketplace add mongodb/agent-skills 官方安装步骤 |
| OpenClaw | 未验证 | 官方仅列出 Claude / Cursor / Codex / GitHub Copilot / Grok；SKILL.md 遵循开放 Agent Skills 标准格式，理论上可手动复制 skills/mongodb-connection/ 目录接入，但未查到官方专项说明 |
| Hermes Agent | 未验证 | 同上，已抓取材料未提及 |
5. 推荐理由
MongoDB 官方出品，把“连接池怎么配”这个几乎每个 MongoDB 应用都会踩的坑，系统化成一套跨驱动语言通用的诊断流程和可计算公式，且不依赖任何外部服务或凭据，安装即可用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | MongoDB 官方出品（一线数据库厂商）；随合集仓库分发，暂未见独立于合集之外的第三方讨论；仓库星数 163（合集整体口径，不代表本技能热度） |
| 可用性 | 9 | 无需账号、API Key 或 MCP Server，复制目录或一条插件命令即用；SKILL.md 约 200 行 + 独立连接监控参考文档，公式示例完整；本技能目录最近提交 2026-05-20，所属仓库整体 2026-07-23 仍有推送 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.3 | 三项均值（7+9+9）/3 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 技能目录仅含 SKILL.md 与 1 篇纯 Markdown 参考文档，不含任何脚本或可执行代码，不请求任何 shell 权限 |
| ② 运行时联网外发 | 无——技能不连接任何 MCP Server 或外部 API，纯基于对话上下文给出配置建议 |
| ③ API Key/凭据 | 不需要——本技能不涉及连接真实数据库，只提供配置参数与代码片段建议 |
| ④ 可疑指令排查 | SKILL.md 全文未发现 prompt injection 或隐藏指令 |
| ⑤ 作者/组织信誉 | MongoDB, Inc.——NASDAQ 上市数据库公司，官方 GitHub 组织账号发布，PR 记录显示内部工单编号（MCP-419）与具名工程师提交 |
| ⑥ License | Apache-2.0，清晰、完全开源可审计 |
| ⑦ 最近维护 | 本技能目录最后提交 2026-05-20；所属仓库整体最后推送 2026-07-23 |
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| database-skills（PlanetScale 官方） | MySQL/PostgreSQL/Vitess 通用数据库知识包，postgres 子技能内附带连接池建议 | 连接池只是其 postgres 子技能的一个章节；本技能只做连接管理一件事，给出跨驱动语言的完整诊断流程和公式 |
| neon-postgres（Neon 官方） | Neon Serverless Postgres 全生命周期技能，涵盖分支、autoscaling、连接池等 | 连接池只是 Neon 平台特性之一，且绑定 Neon 这一家托管服务；本技能不绑定任何托管平台，适用任意 MongoDB 部署形态 |
| 同包姊妹技能 mongodb-schema-design | 聚焦文档模型设计，识别建模反模式 | 与本技能互补——一个管数据怎么存，一个管连接怎么建 |
核心差异化：本技能是同类中唯一把“连接池与超时配置”做成独立、跨驱动语言产品的一款，且不锁定任何托管平台。
8. 用户评价
该技能目前在第三方平台尚无具名的独立用户评价：公开渠道仅见随 MongoDB Agent Skills 合集发布的官方说明，暂未检索到第三方社区讨论或评测。
9. 其他补充
本技能随 MongoDB 官方 Agent Skills 合集分发，同包还含 schema 设计、查询生成优化、Atlas Search/Vector Search 等技能。
10. 安装使用方式
Claude Code（推荐）：
/plugin install mongodb-atlas若连接自建/自托管 MongoDB（非 Atlas 托管），改用：
/plugin install mongodb安装后运行 /reload-plugins 激活。
Codex：
codex plugin marketplace add mongodb/agent-skills而后在 /plugins 中找到 “MongoDB Agent Skills” 安装对应插件。
通用（跨编码助手）：
npx skills add mongodb/agent-skills手动安装： 克隆仓库后将 skills/mongodb-connection/ 目录复制到所用编码助手读取 skills 的位置，无需额外配置即可使用。
11. 注意事项
- 仓库星数为整个官方技能合集口径，非本技能独立仓库数据
- 本技能只给配置建议，不会替用户连接真实数据库或执行变更，代码片段需用户自行应用
- OpenClaw、Hermes Agent 支持情况未获验证，可尝试手动复制目录接入
- 技能面向 MongoDB 官方驱动，若用第三方 ORM（如 Mongoose），部分参数名需自行对照转换