About mongodb-atlas-checker
mongodb-atlas-checker is a skill for reviewing MongoDB Atlas configuration in application projects. It provides a checklist for connection strings, drivers, connection setup, and Atlas access settings, plus common troubleshooting guidance.
Key features
- 01Environment variable and URI checks
- 02Driver dependency verification
- 03Connection setup review
- 04Atlas access configuration checks
- 05Common connection troubleshooting
Use cases
- 01Audit Atlas setup before deployment
- 02Find misconfigured connection strings
- 03Troubleshoot failed database connections
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ shipshitdev/ skills --skill mongodb-atlas-checkerAfter installing, type/mongodb-atlas-checkerin Claude Code to confirm it loaded.
Bundled filesplugin.jsonreferences/full-guide.md
Details
From the project READMEMongoDB Atlas Checker
When to Use
- Verifying MongoDB Atlas backend setup
- Checking connection string configuration
- Validating environment variable setup
- Troubleshooting database connection issues
- Auditing database setup before deployment
Quick Checklist
1. Environment Variables
-
MONGODB_URIexists (not hardcoded) - Uses
mongodb+srv://protocol (required for Atlas) - Includes database name
- Includes
retryWrites=true&w=majority - No credentials in
.env.example
2. Connection String Format
mongodb+srv://USERNAME:PASSWORD@CLUSTER-HOST/DATABASE?retryWrites=true&w=majority
3. Driver Installation
-
mongooseormongodbpackage installed - In dependencies (not devDependencies)
4. Connection Setup
- Singleton pattern (Next.js)
-
MongooseModule.forRoot()(NestJS) - Error handling implemented
5. Atlas Configuration
- IP whitelist configured
- Database user exists with permissions
- SSL/TLS enabled (default with
mongodb+srv://)
Common Issues
| Issue | Solution |
|---|---|
Missing MONGODB_URI | Add to .env.local or .env |
| Wrong protocol | Use mongodb+srv:// not mongodb:// |
| Multiple connections (Next.js) | Use singleton pattern |
| Connection timeout | Check IP whitelist in Atlas |
| Auth failed | Verify credentials, URL-encode special chars |
Recommended Connection Options
{
retryWrites: true,
w: 'majority',
maxPoolSize: 10,
serverSelectionTimeoutMS: 5000,
bufferCommands: false,
}
For detailed setup patterns, verification scripts, and complete examples: references/full-guide.md
Comments
Markdown supported