mcpField
M
mongoose-mongodb

mongoose-mongodb

github.com/pluginagentmarketplaceData & databases2694 installsUpdated 42w ago
Repository

About mongoose-mongodb

mongoose-mongodb is a learning skill for Node.js developers working with MongoDB through Mongoose. It covers database setup, modeling, querying, and advanced patterns from beginner to advanced topics.

Key features

  1. 01Connection setup and error handling
  2. 02Schema and model definition
  3. 03CRUD operations and queries
  4. 04Relationships and population
  5. 05Indexes, middleware, and virtuals
  6. 06Aggregation and transactions

Use cases

  1. 01Connect a Node.js app to MongoDB
  2. 02Model and validate application data
  3. 03Query related documents
  4. 04Optimize common database operations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/pluginagentmarketplace/custom-plugin-nodejs --skill mongoose-mongodb

After installing, type/mongoose-mongodbin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/
config.yaml
references/
GUIDE.md
scripts/
helper.py

Details

From the project README

Mongoose & MongoDB Skill

Master MongoDB database integration in Node.js with Mongoose, the elegant object modeling library.

Quick Start

Connect and CRUD in 4 steps:

  1. Install - npm install mongoose
  2. Connect - mongoose.connect(uri)
  3. Define Schema - Create data models
  4. CRUD - Create, Read, Update, Delete

Core Concepts

Connection Setup
const mongoose = require('mongoose');

mongoose.connect(process.env.MONGODB_URI, {
  useNewUrlParser: true,
  useUnifiedTopology: true
});

mongoose.connection.on('connected', () => {
  console.log('MongoDB connected');
});
Schema & Model
const userSchema = new mongoose.Schema({
  name: {
    type: String,
    required: [true, 'Name is required'],
    trim: true,
    minlength: 3,
    maxlength: 50
  },
  email: {
    type: String,
    required: true,
    unique: true,
    lowercase: true
  },
  age: {
    type: Number,
    min: 18,
    max: 120
  },
  role: {
    type: String,
    enum: ['user', 'admin'],
    default: 'user'
  }
}, {
  timestamps: true  // createdAt, updatedAt
});

const User = mongoose.model('User', userSchema);
CRUD Operations
// Create
const user = await User.create({
  name: 'John Doe',
  email: '[email protected]'
});

// Read
const users = await User.find({ age: { $gte: 18 } });
const user = await User.findById(id);
const user = await User.findOne({ email: '[email protected]' });

// Update
const updated = await User.findByIdAndUpdate(
  id,
  { name: 'Jane Doe' },
  { new: true, runValidators: true }
);

// Delete
await User.findByIdAndDelete(id);
await User.deleteMany({ age: { $lt: 18 } });
Relationships & Population
const postSchema = new mongoose.Schema({
  title: String,
  content: String,
  author: {
    type: mongoose.Schema.Types.ObjectId,
    ref: 'User'
  }
});

// Populate relationship
const post = await Post.findById(id).populate('author');
// post.author is now full user object

Learning Path

Beginner (2-3 weeks)
  • ✅ Install MongoDB and Mongoose
  • ✅ Create schemas and models
  • ✅ CRUD operations
  • ✅ Basic queries
Intermediate (4-5 weeks)
  • ✅ Relationships and population
  • ✅ Validation and middleware
  • ✅ Indexes for performance
  • ✅ Query operators
Advanced (6-8 weeks)
  • ✅ Aggregation pipelines
  • ✅ Transactions
  • ✅ Schema design patterns
  • ✅ Performance optimization

Advanced Features

Indexes
userSchema.index({ email: 1 }, { unique: true });
userSchema.index({ name: 1, age: -1 });
Middleware (Hooks)
userSchema.pre('save', async function(next) {
  if (this.isModified('password')) {
    this.password = await bcrypt.hash(this.password, 10);
  }
  next();
});
Virtual Properties
userSchema.virtual('fullName').get(function() {
  return `${this.firstName} ${this.lastName}`;
});
Aggregation Pipeline
const stats = await User.aggregate([
  { $match: { age: { $gte: 18 } } },
  { $group: {
    _id: '$role',
    count: { $sum: 1 },
    avgAge: { $avg: '$age' }
  }},
  { $sort: { count: -1 } }
]);

Query Operators

// Comparison
User.find({ age: { $gt: 18 } })     // Greater than
User.find({ age: { $gte: 18 } })    // Greater or equal
User.find({ age: { $lt: 65 } })     // Less than
User.find({ age: { $lte: 65 } })    // Less or equal
User.find({ age: { $ne: 30 } })     // Not equal

// Logical
User.find({ $and: [{ age: { $gte: 18 } }, { age: { $lte: 65 } }] })
User.find({ $or: [{ role: 'admin' }, { role: 'moderator' }] })

// Array
User.find({ tags: { $in: ['node', 'mongodb'] } })
User.find({ tags: { $nin: ['deprecated'] } })

// Regex
User.find({ email: /gmail\.com$/ })

Best Practices

  • ✅ Use environment variables for connection strings
  • ✅ Create indexes for frequently queried fields
  • ✅ Use lean() for read-only queries (better performance)
  • ✅ Validate data at schema level
  • ✅ Use transactions for multi-document operations
  • ✅ Handle connection errors properly
  • ✅ Close connections on app shutdown

When to Use

Use MongoDB with Mongoose when:

  • Building Node.js applications
  • Need flexible schema (document-based)
  • Handling large volumes of data
  • Rapid prototyping and iteration
  • Working with JSON-like data

Related Skills

  • Express REST API (connect to MongoDB)
  • Async Programming (async database operations)
  • JWT Authentication (store users)
  • Jest Testing (test database operations)

Resources

Comments

Markdown supported