Spring AI MCP Weather Server Sample with WebMVC Starter

What is 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.

How to use Spring AI MCP Weather Server Sample with WebMVC Starter?

Build the project using ./mvnw clean install -DskipTests. Run the server in default WebMVC SSE mode with java -jar target/mcp-weather-starter-webmvc-server-0.0.1-SNAPSHOT.jar or enable STDIO transport by setting the appropriate properties. Configure server identification, transport, and notification settings via application.properties.

Key features of Spring AI MCP Weather Server Sample with WebMVC Starter

• Integration with spring-ai-mcp-server-webmvc-spring-boot-starter
• Supports both SSE (Server-Sent Events) and STDIO transports
• Automatic tool registration using Spring AI’s @Tool annotation
• Two weather tools: forecast by location and alerts by US state
• Auto-configured SSE endpoints with WebMVC transport
• Optional change notifications for resources, tools, and prompts

Use cases of Spring AI MCP Weather Server Sample with WebMVC Starter

• Providing weather forecast data to AI assistants via MCP protocol
• Retrieving weather alerts for a specific US state
• Demonstrating how to build an MCP server with Spring Boot and WebMVC
• Testing MCP client-server interactions with both STDIO and SSE transports

FAQ from Spring AI MCP Weather Server Sample with WebMVC Starter

How do I run the server in STDIO mode instead of SSE?

Set the properties spring.ai.mcp.server.stdio=true and spring.main.web-application-type=none when starting the JAR.

What tools does the server provide?

Two tools: getWeatherForecastByLocation (latitude/longitude) and getAlerts (two-letter US state code).

What is the runtime dependency to use this server?

The project requires the spring-ai-mcp-server-webmvc-spring-boot-starter dependency, which includes spring-boot-starter-web and mcp-spring-webmvc.

Where does the weather data come from?

The server retrieves weather information from the National Weather Service API (weather.gov).

How can I connect a client to this server?

You can connect via SSE using HttpClientSseClientTransport or via STDIO using StdioClientTransport. The sample also provides boot-starter client configurations for both transports.