Spring Io MCP

🚀 Spring I/O MCP Server

A Model Context Protocol (MCP) server that offers AI assistants access to Spring I/O 2025 conference session data, exposing comprehensive conference information via a standardized MCP interface.

🚀 Quick Start

The Spring I/O MCP Server is an MCP-compliant server that provides AI assistants with access to Spring I/O 2025 conference session data. To get started, follow the steps below to build, test, and run the application.

✨ Features

• Conference Session Access: It has a complete database of Spring I/O 2025 sessions.
• MCP Compliance: Fully compatible with the MCP standard for seamless AI integration.
• Rich Session Data: Includes details such as speakers, room assignments, session types, and timing.
• Spring Boot Integration: Built with Spring Boot 3.5 and Spring AI MCP support.
• JSON Data Source: Enables flexible data management through JSON configuration.

📦 Installation

Project Requirements

• Java: Version 24 or higher
• Maven: 3.6+ (wrapper included)
• Spring Boot: 3.5.0
• Spring AI: 1.0.0

Dependencies

The project relies on several key dependencies:

• spring-boot-starter-web: Core Spring Boot web functionality.
• spring-ai-starter-mcp-server-webmvc: Spring AI MCP server implementation.
• spring-boot-starter-test: Testing framework.
• jackson-databind: JSON processing (included with Spring Boot).

Building the Project

The project comes with Maven wrapper scripts for easy building:

# On Unix/macOS
./mvnw clean compile

# On Windows
mvnw.cmd clean compile

Running Tests

Verify the project by running the test suite:

# Unix/macOS
./mvnw test

# Windows
mvnw.cmd test

💻 Usage Examples

Standard Execution

Build and run the application using Maven:

# Build the JAR file
./mvnw clean package

# Run the application
java -jar target/spring-io-mcp-0.0.1-SNAPSHOT.jar

Development Mode

For development, you can run directly with Maven:

./mvnw spring-boot:run

MCP Server Configuration

The application is configured as an MCP server with the following settings:

• Server Name: spring-io-sessions-mcp
• Version: 0.0.1
• Transport: STDIO (Standard Input/Output)
• Application Type: Non-web (console application)

Important STDIO Configuration: When using STDIO transport, disable Spring Boot's banner and logging to prevent interference with MCP communication:

# Disable banner and logging for STDIO transport
spring.main.banner-mode=off
logging.level.root=OFF

Code Examples

Basic Usage

The server works with session data structured as follows:

public record Session(
    String day, 
    String time, 
    String title, 
    String type, 
    String[] speakers, 
    String room
) {}

Advanced Usage

Conference information is represented using this structure:

public record Conference(
    String name, 
    int year, 
    String[] dates, 
    String location, 
    List<Session> sessions
) {}

The core functionality is exposed through an MCP tool:

@Tool(
    name = "spring-io-sessions", 
    description = "Returns all sessions for Spring I/O 2025 Conference"
)
public List<Session> findAllSessions() {
    return sessions;
}

The application registers MCP tools using Spring's configuration:

@Bean
public List<ToolCallback> springIOSessionTools(SessionTools sessionTools) {
    return List.of(ToolCallbacks.from(sessionTools));
}

Sessions are loaded from JSON during application startup:

@PostConstruct
public void init() {
    try (InputStream inputStream = 
         TypeReference.class.getResourceAsStream("/sessions.json")) {
        var conference = objectMapper.readValue(inputStream, Conference.class);
        this.sessions = conference.sessions();
    } catch (IOException e) {
        throw new RuntimeException("Failed to read JSON data", e);
    }
}

📚 Documentation

Data Configuration

Session Types

The conference features various session types:

• talks: Technical presentations and in - depth explorations.
• workshops: Hands - on learning sessions.
• keynote: Major conference presentations.
• break: Coffee breaks and networking time.
• networking: Social events and community building.
• logistics: Registration and organizational events.

Sample Session Data

Here's an example of session data structure:

{
  "day": "2025-05-22",
  "time": "11:00-11:50",
  "title": "Demystifying Spring Boot Magic",
  "type": "talk",
  "speakers": ["Patrick Baumgartner"],
  "room": "Auditorium"
}

MCP Integration

Connecting to AI Assistants

This server can be connected to AI assistants supporting MCP, offering:

1. Session Discovery: Find sessions by various criteria.
2. Speaker Information: Access speaker details for each session.
3. Schedule Navigation: Browse sessions by day and time.
4. Room Management: Understand venue layout and session locations.

Tool Registration

The MCP server automatically registers the spring-io-sessions tool, making it available for connected AI clients to query conference data.

Development Notes

Project Structure

src/main/java/dev/danvega/spring_io_mcp/
├── Application.java          # Main application and MCP configuration
├── SessionTools.java         # MCP tool implementation
├── Session.java             # Session data model
└── Conference.java          # Conference data model

src/main/resources/
├── application.properties   # Spring configuration
└── sessions.json           # Conference session data

Configuration Properties

Key application properties for MCP server operation:

spring.ai.mcp.server.stdio=true
spring.ai.mcp.server.name=spring-io-sessions-mcp
spring.ai.mcp.server.version=0.0.1
spring.main.web-application-type=none

# Critical for STDIO transport - prevents output corruption
spring.main.banner-mode=off
logging.level.root=OFF

Extending the Server

To add new tools or modify session data:

1. Update sessions.json with new conference information.
2. Add new @Tool annotated methods to SessionTools.
3. Register additional tool callbacks in Application.java.
4. Rebuild and restart the server.

Spring I/O 2025 Conference Details

This server contains complete session data for:

• Conference: Spring I/O 2025
• Dates: May 22 - 23, 2025
• Location: Barcelona, Fira de Barcelona
• Sessions: 80+ talks, workshops, and events
• Tracks: Multiple parallel tracks covering Spring ecosystem topics

The conference covers cutting - edge topics in Spring Framework, Spring Boot, Spring AI, cloud - native development, and modern Java practices.

Conclusion

The Spring I/O MCP Server serves as a bridge between AI assistants and conference data, enabling intelligent interactions with Spring I/O 2025 session information. Whether you're building AI - powered conference apps, creating smart scheduling assistants, or developing conference navigation tools, this MCP server provides the foundation for AI - enhanced conference experiences.

Ready to integrate AI with conference data? Start by running the server and connecting it to your favorite MCP - compatible AI assistant to explore the rich world of Spring I/O sessions!