mcpField
M
mongodb-atlas-checker

mongodb-atlas-checker

github.com/shipshitdev数据与数据库38166 次安装2 天前更新
代码仓库

关于 mongodb-atlas-checker

mongodb-atlas-checker 是用于检查应用项目中 MongoDB Atlas 配置的技能，涵盖连接字符串、驱动、连接设置和 Atlas 访问配置，并提供常见故障排查指引。

主要功能

  1. 01环境变量和 URI 检查
  2. 02驱动依赖验证
  3. 03连接设置审查
  4. 04Atlas 访问配置检查
  5. 05常见连接故障排查

适用场景

  1. 01部署前审查 Atlas 配置
  2. 02查找连接字符串配置错误
  3. 03排查数据库连接失败

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/shipshitdev/skills --skill mongodb-atlas-checker

安装后在 Claude Code 中输入/mongodb-atlas-checker确认已加载。

附带文件plugin.jsonreferences/full-guide.md

详细介绍

MongoDB Atlas 检查器

适用场景

  • 验证 MongoDB Atlas 后端设置
  • 检查连接字符串配置
  • 验证环境变量设置
  • 排查数据库连接问题
  • 部署前审查数据库设置

快速检查清单

1. 环境变量
  • 存在 MONGODB_URI（未硬编码）
  • 使用 mongodb+srv:// 协议（Atlas 必需）
  • 包含数据库名称
  • 包含 retryWrites=true&w=majority
  • .env.example 中不包含凭据
2. 连接字符串格式
mongodb+srv://USERNAME:PASSWORD@CLUSTER-HOST/DATABASE?retryWrites=true&w=majority
3. 驱动安装
  • 已安装 mongoose 或 mongodb 包
  • 位于 dependencies 中（而非 devDependencies）
4. 连接设置
  • 单例模式（Next.js）
  • MongooseModule.forRoot()（NestJS）
  • 已实现错误处理
5. Atlas 配置
  • 已配置 IP 白名单
  • 数据库用户已创建并拥有相应权限
  • 已启用 SSL/TLS（mongodb+srv:// 默认启用）

常见问题

问题解决方案
缺少 MONGODB_URI添加到 .env.local 或 .env
协议错误使用 mongodb+srv://，而非 mongodb://
存在多个连接（Next.js）使用单例模式
连接超时检查 Atlas 中的 IP 白名单
身份验证失败验证凭据，并对特殊字符进行 URL 编码

建议的连接选项

{
  retryWrites: true,
  w: 'majority',
  maxPoolSize: 10,
  serverSelectionTimeoutMS: 5000,
  bufferCommands: false,
}

详细设置模式、验证脚本和完整示例： references/full-guide.md

评论

支持 Markdown