Controle JHipster com seu agente de IA: introduzindo jhipster-mcp (v0.0.4)

Resumo — jhipster-mcp é um servidor de Protocolo de Contexto de Modelo de código aberto que permite que um agente de IA gere e evolua aplicações JHipster para você. Você descreve o que deseja em linguagem simples; o agente escreve JDL e controla o CLI do JHipster. Está no npm — aponte seu host MCP para ele com uma linha. v0.0.4 é o primeiro lançamento público.

📦 npm: https://www.npmjs.com/package/jhipster-mcp
🧑‍💻 GitHub: https://github.com/avdev4j/jhipster-mcp

A ideia

O JHipster sempre foi sobre velocidade: escafoldar um aplicativo Spring Boot de qualidade de produção + frontend moderno em minutos, modelar seu domínio com JDL (Linguagem de Domínio JHipster) e deixar o gerador escrever o código básico.

Agentes de codificação de IA são ótimos em intenção: você diz o que deseja, eles descobrem os passos.

jhipster-mcp conecta os dois. Ele expõe o JHipster como um conjunto de ferramentas MCP que um agente pode chamar. Então, em vez de lembrar a sintaxe do JDL e as flags do CLI, você diz:

"Crie um monólito JHipster em /tmp/shop com PostgreSQL e um frontend Angular, além de uma entidade Produto (nome, preço) e uma Categoria com um para muitos para produtos. Paginar tudo."

…e o agente compõe um JDL válido, executa o gerador e transmite o resultado de volta.

Objetivos

• Tornar o JHipster conversacional. Intenção em linguagem natural → JDL correto → código gerado real.
• Manter seguro e previsível. Não interativo, sem shell, entrada validada, sem gravações surpresa.
• Ser amigável para máquinas. Retornar resultados estruturados que um agente possa raciocinar, não apenas logs.
• Confiar no JHipster, não reinventá-lo. Ele gera o seu CLI JHipster; o gerador permanece a fonte da verdade.

Para quem é

• Desenvolvedores JHipster que desejam escafoldar e evoluir aplicativos mais rapidamente a partir de seu editor de IA.
• Equipes que estão padronizando no JHipster e desejam diretrizes sobre como o gerador é invocado.
• Curiosos de IA / MCP interessados em envolver um CLI de desenvolvedor real e com estado como ferramentas MCP.

Se você usa Claude Code, Claude Desktop, Cursor, ou qualquer host compatível com MCP, você pode conectá-lo hoje.

O que você pode fazer com isso

O servidor oferece 9 ferramentas, priorizando JDL:

Ele também expõe um resumo gramatical do JDL como um recurso MCP, para que o agente escreva JDL válido na primeira tentativa.

O que há na v0.0.4 — os destaques

Este primeiro lançamento foca em tornar cada chamada de ferramenta confiável e legível para o agente:

🔄 Transmissão de progresso ao vivo

A geração completa do aplicativo pode levar de 30 a 90 segundos. Em vez de parecer congelado, o servidor transmite a saída do gerador como notificações de progresso MCP em tempo real.

✅ Validação + um verdadeiro dry-run

Você pode validar JDL ou visualizar uma alteração sem tocar em seu projeto.

Há uma pegadinha divertida aqui: a própria flag --dry-run do JHipster apenas imprime conflitos — ainda assim grava arquivos (confirmei isso contra o CLI real). Portanto, uma "pré-visualização" baseada em flags modificaria silenciosamente seu projeto. O jhipster-mcp faz em vez disso uma pré-visualização real: ele gera em um diretório temporário descartável (copiando o .yo-rc.json e o .jhipster/ do seu projeto para contexto), analisa o que seria produzido e descarta tudo. Seu projeto nunca é modificado.

📦 Saída estruturada

Cada ferramenta retorna JSON legível por máquina juntamente com o texto legível por humanos, para que o agente raciocine sobre os dados em vez de raspar logs:

{
  "command": "jhipster jdl changes.jdl --force --skip-git",
  "exitCode": 0,
  "success": true,
  "dryRun": false,
  "entities": ["Customer", "Order"],
  "filesChanged": [{ "action": "create", "path": "src/main/java/..." }],
  "warnings": []
}

Por que é seguro por design

• Sem shell. O CLI é iniciado com shell: false e uma lista de permissões de argumentos — sem injeção de comandos.
• Construtores JDL validados. Nomes de entidade/campo/tipo são verificados contra padrões rigorosos antes que qualquer JDL seja escrito.
• Não interativo sempre. Executa com --force --skip-git e CI=true; nunca fica preso em um prompt.
• Limitado. Cada ferramenta leva um workingDirectory explícito; o servidor não atuará fora dele.

Por trás dos panos, é TypeScript no o