Spring Initializr MCP Server

Este es un servidor MCP (Model Context Protocol) construido con Spring Boot 4 y Spring AI. Su propósito es permitir a asistentes de IA (como Claude Desktop o IDEs compatibles) generar y descargar proyectos de Spring Boot directamente utilizando la API de start.spring.io.

Características

• Generación de Proyectos: Crea proyectos Spring Boot completos (zip) y los descomprime en tu sistema de archivos local.
• Personalización Completa: Soporta la configuración de:
  • Lenguaje (Java, Kotlin, Groovy)
  • Sistema de construcción (Gradle, Maven)
  • Versión de Spring Boot y Java
  • Metadatos del proyecto (Group, Artifact, Name, Description, Package)
  • Dependencias (Web, JPA, Security, etc.)
• Integración MCP: Funciona sobre stdio, lo que permite una integración fluida con clientes MCP locales.

Requisitos

• Java 21 o superior.
• Gradle (o usar el wrapper incluido ./gradlew).

Configuración y Uso

1. Construir el Proyecto

Para generar el archivo JAR ejecutable, corre el siguiente comando en la raíz del proyecto:

./gradlew build

El archivo JAR se generará en build/libs/springintializrmcp-0.0.1-SNAPSHOT.jar.

2. Configurar en Claude Desktop (u otro cliente MCP)

Para usar este servidor con Claude Desktop, necesitas agregar la configuración en tu archivo claude_desktop_config.json.

Ubicación del archivo de configuración:

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

Contenido de la configuración:

{
  "mcpServers": {
    "spring-initializr": {
      "command": "java",
      "args": [
        "-jar",
        "/ruta/absoluta/a/tu/proyecto/springintializrmcp/build/libs/springintializrmcp-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

Asegúrate de reemplazar /ruta/absoluta/a/tu/proyecto/... con la ruta real donde se encuentra el JAR generado.

3. Reiniciar Claude Desktop

Una vez guardado el archivo de configuración, reinicia la aplicación Claude Desktop. Deberías ver un indicador (un icono de enchufe) que muestra que el servidor MCP está conectado.

Herramientas Disponibles

El servidor expone la siguiente herramienta (Tool) al modelo de IA:

createSpringProject

Genera un nuevo proyecto de Spring Boot y lo descomprime localmente.

Parámetros:

Parámetro	Descripción	Valor por defecto
type	Tipo de proyecto (gradle-project, maven-project, gradle-project-kotlin)	gradle-project-kotlin
language	Lenguaje (java, kotlin, groovy)	kotlin
bootVersion	Versión de Spring Boot	3.4.2
groupId	Group ID (ej: com.ejemplo)	com.custer
artifactId	Artifact ID (ej: demo)	demo
name	Nombre del proyecto	demo
description	Descripción del proyecto	Demo project...
packageName	Paquete raíz	com.custer.demo
packaging	Empaquetado (jar, war)	jar
javaVersion	Versión de Java (17, 21)	21
dependencies	Lista de dependencias (ej: ['web', 'data-jpa'])	[]
targetPath	Ruta absoluta donde se creará el proyecto	null (usa el directorio actual del proceso)
configurationFileFormat	Formato del archivo de configuración (properties, yaml)	yaml

Ejemplo de Prompt:

"Crea un proyecto Spring Boot con Kotlin, Gradle, Java 21 y las dependencias Web y Data JPA en la carpeta /Users/miusuario/proyectos/nuevo-api"

Desarrollo

Este proyecto utiliza:

• Spring Boot 4.0.2
• Spring AI 2.0.0-M2 (Soporte MCP)
• Kotlin

La comunicación se realiza a través de stdio. Los logs de la aplicación se redirigen a stderr para no interferir con el protocolo JSON-RPC que viaja por stdout.