Spring AI MCP Weather Server Sample with WebMVC Starter

This sample project demonstrates how to create an MCP server using the Spring AI MCP Server Boot Starter with WebMVC transport. It implements a weather service that exposes tools for retrieving weather information using the National Weather Service API.

For more information, see the MCP Server Boot Starter reference documentation.

Overview

The sample showcases:
- Integration with spring-ai-mcp-server-webmvc-spring-boot-starter
- Support for both SSE (Server-Sent Events) and STDIO transports
- Automatic tool registration using Spring AI's @Tool annotation
- Two weather-related tools:
- Get weather forecast by location (latitude/longitude)
- Get weather alerts by US state

Dependencies

The project requires the Spring AI MCP Server WebMVC Boot Starter:

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-mcp-server-webmvc-spring-boot-starter</artifactId>
</dependency>

This starter provides:
- HTTP-based transport using Spring MVC (WebMvcSseServerTransport)
- Auto-configured SSE endpoints
- Optional STDIO transport
- Included spring-boot-starter-web and mcp-spring-webmvc dependencies

Building the Project

Build the project using Maven:

./mvnw clean install -DskipTests

Running the Server

The server supports two transport modes:

WebMVC SSE Mode (Default)

java -jar target/mcp-weather-starter-webmvc-server-0.0.1-SNAPSHOT.jar

STDIO Mode

java -Dspring.ai.mcp.server.stdio=true -Dspring.main.web-application-type=none -jar target/mcp-weather-starter-webmvc-server-0.0.1-SNAPSHOT.jar

Configuration

Configure the server through application.properties:

```properties