NestJsMcp

---

Visão Geral

O Servidor MCP NestJS é um poderoso servidor de Model Context Protocol que fornece mais de 40 ferramentas especializadas para desenvolvimento NestJS. Ele se integra perfeitamente com assistentes de IA como Claude Desktop, Cursor, Claude Code CLI e qualquer cliente compatível com MCP.

Por que NestJS MCP?

• Acelere o Desenvolvimento: Gere código boilerplate, controllers, services e recursos CRUD completos em segundos
• Melhores Práticas Incorporadas: Todo o código gerado segue as melhores práticas e convenções do NestJS
• Segurança em Primeiro Lugar: Ferramentas de auditoria de segurança integradas para identificar vulnerabilidades no seu código
• Ecossistema Completo: Do scaffolding à implantação, cobre todo o ciclo de vida do desenvolvimento
• Aprendizado com IA: Explicações instantâneas de conceitos, decorators e padrões do NestJS

---

Recursos

Geração de Código

Gere código NestJS pronto para produção com decorators, tipos e melhores práticas adequados.

Scaffolding de Projetos

Crie projetos NestJS completos com seu banco de dados, autenticação e ferramentas preferidos pré-configurados.

Ferramentas de Teste

Gere testes unitários, testes E2E, fábricas de teste e repositórios mock automaticamente.

Auditoria de Segurança

Examine seu código em busca de vulnerabilidades comuns (injeção de SQL, XSS, segredos codificados, etc.) com classificações de gravidade.

Automação de Implantação

Gere Docker, Kubernetes, pipelines de CI/CD, configurações de Nginx e muito mais.

Documentação e Aprendizado

Acesse documentação, conceitos e melhores práticas do NestJS diretamente pelo seu assistente de IA.

---

Instalação

Pré-requisitos

• Node.js 18.x ou superior
• npm 9.x ou superior

Início Rápido

# 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

Scripts de Build

Comando	Descrição
npm run build	Compilar TypeScript para JavaScript
npm run dev	Modo de observação para desenvolvimento
npm start	Executar o servidor MCP

---

Configuração

Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

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

Adicione às suas configurações MCP do Cursor (.cursor/mcp.json):

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

Claude Code CLI

Adicione às suas configurações do Claude Code:

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

Nota: Substitua /absolute/path/to/nestjs-mcp pelo caminho real da sua instalação.

---

Ferramentas Disponíveis

Ferramentas de Geração de Código

Ferramenta	Descrição
nestjs_generate_controller	Gerar controllers com operações CRUD opcionais
nestjs_generate_service	Gerar services com integração de repositório
nestjs_generate_module	Gerar modules com providers e imports
nestjs_generate_resource	Gerar recursos CRUD completos (module, controller, service, entity, DTOs)
nestjs_generate_dto	Gerar DTOs com decorators class-validator
nestjs_generate_entity	Gerar entidades TypeORM/Mongoose
nestjs_generate_guard	Gerar guards de auth, roles ou personalizados
nestjs_generate_interceptor	Gerar interceptors de logging, transform, cache ou timeout
nestjs_generate_pipe	Gerar pipes de validação ou transformação
nestjs_generate_filter	Gerar filtros de exceção
nestjs_generate_middleware	Gerar middleware personalizado

Ferramentas de Scaffolding de Projetos

Ferramenta	Descrição
nestjs_scaffold_project	Gerar um projeto NestJS completo com opções personalizáveis

Opções de Scaffolding:

• Banco de Dados: PostgreSQL, MySQL, MongoDB, SQLite
• Autenticação: Auth baseada em JWT com Passport
• Documentação: Integração Swagger/OpenAPI
• Containerização: Docker e Docker Compose
• Testes: Configuração Jest com cobertura
• WebSockets: Integração Socket.io

Ferramentas de Teste

Ferramenta	Descrição
nestjs_generate_unit_test	Gerar testes unitários para services
nestjs_generate_controller_test	Gerar testes unitários de controller
nestjs_generate_e2e_test	Gerar testes de ponta a ponta
nestjs_generate_test_factory	Gerar fábricas de dados de teste
nestjs_generate_mock_repository	Gerar repositório mock para testes
nestjs_generate_test_helpers	Gerar utilitários de teste comuns

Ferramentas de Segurança

Ferramenta	Descrição
nestjs_security_audit	Auditoria de segurança abrangente do seu código
nestjs_security_checklist	Obter lista de verificação de melhores práticas de segurança
nestjs_generate_secure_main	Gerar main.ts endurecido com segurança

Verificações de Segurança Incluem:

• Vulnerabilidades de injeção de SQL
• Cross-Site Scripting (XSS)
• Segredos e credenciais codificados
• Práticas criptográficas inseguras
• Vulnerabilidades de path traversal
• Riscos de injeção de comandos
• Exposição de dados sensíveis
• Headers de segurança ausentes

Ferramentas de Implantação

Ferramenta	Descrição
nestjs_generate_dockerfile	Gerar Dockerfile multi-estágio otimizado
nestjs_generate_docker_compose	Gerar configuração Docker Compose
nestjs_generate_github_actions	Gerar pipeline CI/CD do GitHub Actions
nestjs_generate_gitlab_ci	Gerar pipeline CI/CD do GitLab
nestjs_generate_kubernetes	Gerar manifestos de implantação Kubernetes
nestjs_generate_pm2_config	Gerar configuração de ecossistema PM2
nestjs_generate_nginx_config	Gerar configuração de proxy reverso Nginx
nestjs_generate_systemd_service	Gerar arquivo de serviço systemd
nestjs_generate_env_files	Gerar arquivos de configuração de ambiente

Ferramentas de Documentação e Aprendizado

Ferramenta	Descrição
nestjs_explain_concept	Explicação detalhada de conceitos do NestJS
nestjs_explain_decorator	Explicar decorators específicos com exemplos
nestjs_explain_cli	Explicar comandos CLI do NestJS
nestjs_list_schematics	Listar todos os schematics disponíveis do NestJS
nestjs_list_decorators	Listar decorators por categoria
nestjs_best_practices	Obter melhores práticas por categoria
nestjs_recommended_packages	Obter pacotes recomendados por caso de uso
nestjs_search_docs	Pesquisar na documentação do NestJS
nestjs_request_lifecycle	Entender o ciclo de vida de requisições
nestjs_dependency_injection	Aprender sobre injeção de dependência
nestjs_get_common_errors	Obter soluções para erros comuns

Ferramentas de Análise de Código

Ferramenta	Descrição
nestjs_analyze_code	Analisar código em busca de problemas e anti-padrões
nestjs_suggest_improvements	Obter sugestões de melhoria
nestjs_validate_structure	Validar estrutura do projeto

---

Recursos Disponíveis

Acesse a documentação do NestJS diretamente pelos recursos MCP:

URI do Recurso	Descrição
nestjs://docs/concepts/{topic}	Conceitos principais (modules, controllers, providers, etc.)
nestjs://docs/techniques/{topic}	Técnicas (banco de dados, auth, validação, cache, etc.)
nestjs://docs/advanced/{topic}	Tópicos avançados (CQRS, eventos, microservices, etc.)
nestjs://docs/cli/commands	Referência de comandos CLI
nestjs://docs/cli/schematics	Referência de schematics
nestjs://docs/decorators	Referência completa de decorators
nestjs://docs/best-practices	Guia de melhores práticas
nestjs://docs/packages	Pacotes recomendados
nestjs://docs/errors/{error}	Erros comuns e soluções

---

Exemplos de Uso

Gerar um Recurso CRUD Completo

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

Isso cria:

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

Fazer Scaffolding de um Novo Projeto

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

Isso gera uma estrutura de projeto completa com:

• Configuração de banco de dados
• Módulo de autenticação
• Configuração Swagger
• Arquivos Docker e Docker Compose
• Configuração de ambiente
• Configuração de testes

Auditoria de Segurança

"Run a security audit on my NestJS application"

Retorna:

• Lista de vulnerabilidades com classificações de gravidade
• Referências CWE
• Sugestões de remediação
• Pontuação geral de segurança (nota A-F)

Gerar Pipeline CI/CD

"Generate a GitHub Actions workflow for my NestJS project"

Cria um pipeline CI/CD completo com:

• Linting e verificação de tipos
• Testes unitários e E2E
• Build e push Docker
• Estágios de implantação

Gerar Implantação Kubernetes

"Generate Kubernetes manifests for deploying my NestJS app"

Gera:

• Deployment com health checks
• Service (ClusterIP/LoadBalancer)
• ConfigMap
• Template de Secret
• Horizontal Pod Autoscaler
• Configuração de Ingress

Obter Soluções para Erros

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

Retorna:

• Causas comuns
• Soluções passo a passo
• Exemplos de código

---

Estrutura do Projeto

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

---

Tópicos Avançados Abordados

O servidor MCP inclui documentação abrangente e geração de código para:

Tópico	Descrição
CQRS	Padrão Command Query Responsibility Segregation
Orientado a Eventos	Emissores de eventos e event sourcing
Upload de Arquivos	Integração Multer e uploads em streaming
Streaming	SSE e respostas em streaming
Health Checks	Indicadores de saúde Terminus
Agendamento de Tarefas	Cron jobs e intervalos
Compressão	Compressão de respostas Gzip/Brotli
Limitação de Taxa	Throttling e rate limiting
Versionamento de API	Versionamento por URI, header e media type
Serialização	Class-transformer e interceptors

---

Banco de Dados de Erros Comuns

Soluções integradas para erros comuns do NestJS:

• Dependência Circular - Estratégias de detecção e resolução
• Não é Possível Resolver Dependência - Solução de problemas de provider ausente
• Módulo Inválido - Problemas de configuração de módulo
• Elemento Desconhecido - Problemas de template e decorator
• Erros de Timeout - Tratamento de operações assíncronas
• Falhas de Validação - Configuração de DTO e pipe
• Problemas com TypeORM - Problemas de conexão e consulta de banco de dados
• Erros de Autenticação - Configuração JWT e Passport

---

Contribuição

Contribuições são bem-vindas! Veja como você pode ajudar:

Configuração de Desenvolvimento

# 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

Diretrizes de Contribuição

1. Faça um Fork do repositório
2. Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add amazing feature')
4. Envie para o branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

Áreas para Contribuição

• Geradores de código adicionais
• Mais verificações de segurança
• Cobertura estendida de documentação
• Correções de bugs e melhorias
• Alvos de implantação adicionais

---

Solução de Problemas

Problemas Comuns

Servidor MCP Não Inicia

# Ensure the project is built
npm run build

# Check for TypeScript errors
npx tsc --noEmit

Claude Desktop Não Detecta o Servidor

• Verifique se o caminho em claude_desktop_config.json é absoluto
• Reinicie o Claude Desktop após alterações de configuração
• Verifique os logs do Claude Desktop para erros de conexão

Erros de Permissão no Linux/macOS

chmod +x dist/index.js

---

Roadmap

• Geração de código GraphQL
• Scaffolding de microservices
• Modelos de integração gRPC
• Geradores de migração de banco de dados
• Geração de código a partir de especificação OpenAPI
• Suporte a modelos personalizados
• Arquitetura de plugins

---

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

---

Agradecimentos

• NestJS - O framework Node.js progressivo
• Model Context Protocol - A especificação MCP
• Anthropic - Assistente de IA Claude

---