Overview

NestJS MCP Server is a powerful Model Context Protocol server that provides 40+ specialized tools for NestJS development. It integrates seamlessly with AI assistants like Claude Desktop, Cursor, Claude Code CLI, and any MCP-compatible client.

Why NestJS MCP?

• Accelerate Development: Generate boilerplate code, controllers, services, and complete CRUD resources in seconds
• Best Practices Built-in: All generated code follows NestJS best practices and conventions
• Security First: Built-in security audit tools to identify vulnerabilities in your code
• Complete Ecosystem: From scaffolding to deployment, covers the entire development lifecycle
• AI-Powered Learning: Instant explanations of NestJS concepts, decorators, and patterns

Features

Code Generation

Generate production-ready NestJS code with proper decorators, types, and best practices.

Project Scaffolding

Create complete NestJS projects with your preferred database, authentication, and tooling pre-configured.

Testing Tools

Generate unit tests, E2E tests, test factories, and mock repositories automatically.

Security Auditing

Scan your code for common vulnerabilities (SQL injection, XSS, hardcoded secrets, etc.) with severity ratings.

Deployment Automation

Generate Docker, Kubernetes, CI/CD pipelines, Nginx configs, and more.

Documentation & Learning

Access NestJS documentation, concepts, and best practices directly through your AI assistant.

Available Tools

Code Generation Tools

Project Scaffolding Tools

Scaffolding Options:

• Database: PostgreSQL, MySQL, MongoDB, SQLite
• Authentication: JWT-based auth with Passport
• Documentation: Swagger/OpenAPI integration
• Containerization: Docker & Docker Compose
• Testing: Jest configuration with coverage
• WebSockets: Socket.io integration

Testing Tools

Security Tools

Security Checks Include:

• SQL Injection vulnerabilities
• Cross-Site Scripting (XSS)
• Hardcoded secrets and credentials
• Insecure cryptographic practices
• Path traversal vulnerabilities
• Command injection risks
• Sensitive data exposure
• Missing security headers

Deployment Tools

Documentation & Learning Tools

Code Analysis Tools

Available Resources

Access NestJS documentation directly through MCP resources:

Project Structure

nestjs-mcp/
├── src/
│   ├── index.ts                    # Main MCP server entry point
│   ├── data/
│   │   ├── nestjs-docs.ts          # Core NestJS documentation
│   │   └── advanced-techniques.ts  # Advanced topics & error solutions
│   ├── tools/
│   │   ├── index.ts                # Tools barrel export
│   │   ├── generate.ts             # Code generation tools
│   │   ├── explain.ts              # Documentation tools
│   │   ├── analyze.ts              # Code analysis tools
│   │   ├── scaffold.ts             # Project scaffolding
│   │   ├── testing.ts              # Test generation tools
│   │   ├── security.ts             # Security audit tools
│   │   └── deployment.ts           # Deployment config generators
│   ├── resources/
│   │   ├── index.ts
│   │   └── documentation.ts        # MCP resources
│   └── prompts/
│       ├── index.ts
│       └── templates.ts            # Prompt templates
├── dist/                           # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Advanced Topics Covered

The MCP server includes comprehensive documentation and code generation for:

Roadmap

• GraphQL code generation
• Microservices scaffolding
• gRPC integration templates
• Database migration generators
• OpenAPI spec to code generation
• Custom template support
• Plugin architecture

Installation

Prerequisites

• Node.js 18.x or higher
• npm 9.x or higher

Quick Start

# Clone the repository
git clone https://github.com/pirumar/NestJsMcp.git
cd nestjs-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Verify installation
npm start

Build Scripts

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "nestjs": {
      "command": "node",
      "args": ["/absolute/path/to/nestjs-mcp/dist/index.js"]
    }
  }
}

Cursor IDE

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "nestjs": {
      "command": "node",
      "args": ["/absolute/path/to/nestjs-mcp/dist/index.js"]
    }
  }
}

Claude Code CLI

Add to your Claude Code settings:

{
  "mcpServers": {
    "nestjs": {
      "command": "node",
      "args": ["/absolute/path/to/nestjs-mcp/dist/index.js"]
    }
  }
}

Note: Replace /absolute/path/to/nestjs-mcp with the actual path to your installation.

Usage Examples

Generate a Complete CRUD Resource

"Generate a complete CRUD resource for 'products' with TypeORM entity"

This creates:

• products.module.ts
• products.controller.ts
• products.service.ts
• product.entity.ts
• create-product.dto.ts
• update-product.dto.ts

Scaffold a New Project

"Scaffold a new NestJS project called 'my-api' with PostgreSQL, JWT auth, Swagger, and Docker"

This generates a complete project structure with:

• Database configuration
• Authentication module
• Swagger setup
• Docker & Docker Compose files
• Environment configuration
• Testing setup

Security Audit

"Run a security audit on my NestJS application"

Returns:

• List of vulnerabilities with severity ratings
• CWE references
• Remediation suggestions
• Overall security score (A-F grade)

Generate CI/CD Pipeline

"Generate a GitHub Actions workflow for my NestJS project"

Creates a complete CI/CD pipeline with:

• Linting and type checking
• Unit and E2E tests
• Docker build and push
• Deployment stages

Generate Kubernetes Deployment

"Generate Kubernetes manifests for deploying my NestJS app"

Generates:

• Deployment with health checks
• Service (ClusterIP/LoadBalancer)
• ConfigMap
• Secret template
• Horizontal Pod Autoscaler
• Ingress configuration

Get Error Solutions

"How do I fix the circular dependency error in NestJS?"

Returns:

• Common causes
• Step-by-step solutions
• Code examples

Common Errors Database

Built-in solutions for common NestJS errors:

• Circular Dependency - Detection and resolution strategies
• Cannot Resolve Dependency - Missing provider troubleshooting
• Invalid Module - Module configuration issues
• Unknown Element - Template and decorator problems
• Timeout Errors - Async operation handling
• Validation Failures - DTO and pipe configuration
• TypeORM Issues - Database connection and query problems
• Authentication Errors - JWT and Passport configuration

Troubleshooting

Common Issues

MCP Server Not Starting

# Ensure the project is built
npm run build

# Check for TypeScript errors
npx tsc --noEmit

Claude Desktop Not Detecting Server

• Verify the path in claude_desktop_config.json is absolute
• Restart Claude Desktop after configuration changes
• Check Claude Desktop logs for connection errors

Permission Errors on Linux/macOS

chmod +x dist/index.js

License

This project is licensed under the MIT License - see the LICENSE file for details.