Table of Contents

MCP Weather Server with HTTP transport

Build a MCP weather Server with HTTP transport.

Authors: Sergio del Amo

Micronaut Version: 4.10.7

1. Getting Started

In this guide, we will create a Micronaut application written in Java.

2. What you will need

To complete this guide, you will need the following:

3. Solution

We recommend that you follow the instructions in the next sections and create the application step by step. However, you can go right to the completed example.

Create an application using the Micronaut Command Line Interface or with Micronaut Launch.

4. What will you build?

In this guide, we will create an MCP Server with Micronaut as the one described in the Build an MCP server tutorial on the Model Context Protocol website.

5. Dependency

Add the Micronaut MCP Server Java SDK dependency to your build file:

pom.xml
<dependency>
    <groupId>io.micronaut.mcp</groupId>
    <artifactId>micronaut-mcp-server-java-sdk</artifactId>
    <scope>compile</scope>
</dependency>

To use Micronaut JSON Schema generation capabilities, add the following dependencies:

pom.xml
<!-- Add the following to your annotationProcessorPaths element -->
<path>
    <groupId>io.micronaut.jsonschema</groupId>
    <artifactId>micronaut-json-schema-processor</artifactId>
</path>
<dependency>
    <groupId>io.micronaut.jsonschema</groupId>
    <artifactId>micronaut-json-schema-annotations</artifactId>
    <scope>compile</scope>
</dependency>

6. Configuration

src/main/resources/application.properties
micronaut.mcp.server.info.name=Weather
micronaut.mcp.server.info.version=0.0.1
(1)
micronaut.mcp.server.transport=HTTP
1 To use Streamable HTTP

7. JSON Schema Generation

An MCP Tool can define its input schema using JSON Schema.

Thanks to Micronaut JSON Schema, we can generate the JSON Schema at compile-time given a Java file.

Create two Java records to model the tools' inputs.

GetAlertInput will be the input schema of the getAlerts tool.

src/main/java/example/micronaut/GetAlertInput.java
package example.micronaut;

import io.micronaut.jsonschema.JsonSchema;
import io.micronaut.serde.annotation.Serdeable;

/**
 *
 * @param state Two-letter US state code (e.g. CA, NY)
 */
@Serdeable (1)
@JsonSchema (2)
public record GetAlertInput(String state) {
}
1 Declare the @Serdeable annotation at the type level in your source code to allow the type to be serialized or deserialized.
2 Annotate the class with @JsonSchema to generate a JSON Schema for class during build time.

Point will be the input schema of the getWeatherForecastByLocation tool.

src/main/java/example/micronaut/Point.java
package example.micronaut;

import io.micronaut.jsonschema.JsonSchema;
import io.micronaut.serde.annotation.Serdeable;

/**
 *
 * @param latitude Latitude of the location
 * @param longitude Longitude of the location
 */
@Serdeable
@JsonSchema
public record Point(double latitude, double longitude) {
}
1 Declare the @Serdeable annotation at the type level in your source code to allow the type to be serialized or deserialized.
2 Annotate the class with @JsonSchema to generate a JSON Schema for class during build time.

8. MCP Tool

The MCP Server exposes two tools: getWeatherForecastByLocation and getAlerts.

src/main/java/example/micronaut/Tools.java
package example.micronaut;

import example.micronaut.weather.WeatherClient;
import io.micronaut.mcp.annotations.Tool;
import jakarta.inject.Singleton;

@Singleton (1)
class Tools {

    private final WeatherClient weatherClient;

    Tools(WeatherClient weatherClient) { (2)
        this.weatherClient = weatherClient;
    }

    @Tool(description = "Get weather forecast for a specific latitude/longitude coordinates") // 3>
    String getWeatherForecastByLocation(Point point) {
        return weatherClient.formattedForecast(point.latitude(), point.longitude());
    }

    @Tool(description = "Get weather alerts for a US state") // 3>
    String getAlerts(GetAlertInput input) {
        return weatherClient.formattedAlerts(input.state());
    }
}
1 Use jakarta.inject.Singleton to designate a class as a singleton.
2 Use constructor injection to inject a bean of type WeatherClient.
3 Annotate a method with @Tool to expose it as an MCP Tool.

WeatherClient is a Micronaut bean which uses the Micronaut HTTP Client to consume https://api.weather.gov API. Please, download the complete project to check the code.

8.1. MCP Inspector

To test the MCP Server, run the MCP inspector.

Select Streamable HTTP as Transport type.

Enter http://localhost:8080/mcp as the URL.

Click connect.

You will be able to list tools and invoke the getWeatherForecastByLocation tool.

The https://api.weather.gov API works only for US locations.

and the getAlerts tool.

mcp weather http

9. Next Steps

Explore more features with Micronaut Guides.

Check the Micronaut MCP documentation and the Micronaut MCP Guides

10. License

All guides are released with an Apache license 2.0 license for the code and a Creative Commons Attribution 4.0 license for the writing and media (images…​).