Spring Initializr MCP Server

An MCP (Model Context Protocol) server that provides access to Spring Initializr functionality, allowing AI assistants to generate and download Spring Boot projects programmatically.

What is this?

This project implements an MCP server that wraps the Spring Initializr API, enabling AI assistants (like Claude) to create Spring Boot projects with custom configurations. Instead of manually visiting start.spring.io, you can now ask your AI assistant to generate projects with specific dependencies, Java versions, and project structures.

Features

- Generate Spring Boot Projects: Create new Spring Boot projects with custom configurations
- Flexible Configuration: Support for different project types (Maven/Gradle), languages (Java/Kotlin/Groovy), and Java versions
- Dependency Management: Add popular Spring Boot dependencies automatically
- Native Compilation: Fast startup times with GraalVM native compilation
- Cross-Platform: Native binaries available for Linux, Windows, and macOS (x64 and ARM64)
- Automatic Extraction: Optional extraction of downloaded ZIP files
- Dynamic Metadata: Automatically fetches latest Spring Boot versions and dependencies

Supported Parameters

When generating a project, you can specify:

- Project Type: maven-project, gradle-project, gradle-project-kotlin
- Language: java, kotlin, groovy
- Java Version: 17, 21, 24 (defaults to 17)
- Packaging: jar, war (defaults to jar)
- Dependencies: Hundreds of Spring Boot starters and dependencies
- Project Metadata: Group ID, Artifact ID, name, description, package name
- Download Options: Custom download location and automatic ZIP extraction

Installation

Download Pre-built Binaries

Download the appropriate binary for your platform from the Releases page:

- Linux x64: springinitializr-mcp-linux-x64
- Windows x64: springinitializr-mcp-windows-x64.exe
- macOS x64: springinitializr-mcp-macos-x64
- macOS ARM64: springinitializr-mcp-macos-arm64

Build from Source

Requirements:
- Java 24
- GraalVM (for native compilation)

git clone https://github.com/hpalma/springinitializr-mcp.git
cd springinitializr-mcp
./gradlew build
./gradlew nativeCompile

Usage with Claude Desktop

Add the MCP server to your Claude Desktop configuration:

macOS/Linux

{
  "mcpServers": {
    "springinitializr": {
      "command": "/path/to/springinitializr-mcp-binary"
    }
  }
}

Windows

{
  "mcpServers": {
    "springinitializr": {
      "command": "C:\\path\\to\\springinitializr-mcp-windows-x64.exe"
    }
  }
}

Example Usage

Once configured, you can ask Claude to generate Spring Boot projects:

> "Create a Spring Boot web application with Spring Data JPA, PostgreSQL, and Spring Security dependencies"

> "Generate a Kotlin Spring Boot project using Gradle with WebFlux and MongoDB"

> "Create a Maven-based Spring Boot project with Thymeleaf, Validation, and Actuator"

The tool will generate and download the project as a ZIP file to your specified location, with optional automatic extraction.

Available Dependencies

The server supports all Spring Initializr dependencies, including:

- Web: Spring Web, WebFlux, GraphQL, REST repositories
- Security: Spring Security, OAuth2, LDAP
- Data: JPA, JDBC, MongoDB, Redis, Elasticsearch, R2DBC
- Messaging: RabbitMQ, Apache Kafka, WebSocket
- Cloud: Spring Cloud Gateway, Config, Eureka, Feign
- Ops: Actuator, Micrometer, Distributed Tracing
- AI: Spring AI with various model providers
- Testing: TestContainers, Contract testing

The dependency list is automatically updated by fetching the latest metadata from Spring Initializr.

Development

Running in Development

```bash