NestJsMcp

A comprehensive Model Context Protocol (MCP) server for NestJS development

Supercharge your NestJS development with AI-powered assistance

Features•Installation•Configuration•Tools•Usage•Contributing

# 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

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

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

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

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

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

- 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

- 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

Access NestJS documentation directly through MCP resources:

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

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

"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

"Run a security audit on my NestJS application"

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

"Generate a GitHub Actions workflow for my NestJS project"

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

"Generate Kubernetes manifests for deploying my NestJS app"

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

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

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

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

The MCP server includes comprehensive documentation and code generation for:

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

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

# 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

- Forkthe repository
- Createa feature branch (git checkout -b feature/amazing-feature)
- Commityour changes (git commit -m 'Add amazing feature')
- Pushto the branch (git push origin feature/amazing-feature)
- Opena Pull Request

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

# Ensure the project is built npm run build # Check for TypeScript errors npx tsc --noEmit

- Verify the path inclaude_desktop_config.jsonis absolute
- Restart Claude Desktop after configuration changes
- Check Claude Desktop logs for connection errors

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

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

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

An MCP extension for the Claude Desktop application that enables automation and integration.