NestJsMcp

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.

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.

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:

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

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:

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

Contributing

Contributions are welcome! Here's how you can help:

Development Setup

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

# Install dependencies
npm install

# Start development mode
npm run dev

Contribution Guidelines

1. Fork the repository

2. Create a feature branch (`git checkout -b feature/amazing-feature`)

3. Commit your changes (`git commit -m 'Add amazing feature'`)

4. Push to the branch (`git push origin feature/amazing-feature`)

5. Open a Pull Request

Areas for Contribution

• Additional code generators
• More security checks
• Extended documentation coverage
• Bug fixes and improvements
• Additional deployment targets

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

Roadmap

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

License

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

Acknowledgments

• NestJS - The progressive Node.js framework
• Model Context Protocol - The MCP specification
• Anthropic - Claude AI assistant