SpringBoot MCP 入门使用步骤详解

2015-09-21 15:49:35 作者：cmlbeliever

这篇文章主要介绍了SpringBoot MCP 入门使用,本文分步骤给大家介绍的非常详细,需要的朋友可以参考下

随着AI的火爆，最近发现MCP在未来确实大有可为，作为一名javaer怎么可以落后在历史洪流呢，根据官网和cursor也从零开始体验一下自定义mcp server。以后可以根据自己业务场景做出各种适合自身业务的工具。
至于什么是MCP 可以到https://modelcontextprotocol.io/introduction看看，里面有非常详细的介绍，这里就不赘述了。
下面开始我们自己的第一个mcp server，按照各种demo 我这里也以获取当前天气和报警信息作为demo，这里会提供两个工具：

根据经纬度获取天气，获取天气后会返回一个token信息
根据token信息获取天气报警

那下面开始我们的开发

第一步初始化pom

新建项目，并且引入spirng-ai

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

第二步编写tools

getWeatherForecastByLocation：这里也是根据官方demo信息进行稍微改造，在获取天气的时候除了经纬度入参外，还需要传入一个期望值，这个值可选范围为aa和hh，主要是mock一些业务场景下入参是枚举类型的场景。
getAlerts：模拟业务场景中有流程上数据依赖的场景，这里的token入参信息是从第一步中获取的

@Service
public class WeatherService {
    /**
     * Get forecast for a specific latitude/longitude
     *
     * @param latitude  Latitude
     * @param longitude Longitude
     * @return The forecast for the given location
     * @throws RestClientException if the request fails
     */
    @Tool(description = "根据经纬度获取当前天气，expectValue可选值为[\"aa\",\"hh\"]")
    public String getWeatherForecastByLocation(@ToolParam(required = true, description = "请输入精度") double latitude,
                                               @ToolParam(required = true, description = "请输入纬度")
                                               double longitude
            , @ToolParam(required = true, description = "请输入期望值") String expectValue
    ) throws Exception {
        if (!"hh".equals(expectValue)) {
            throw new IllegalArgumentException("无效的期望值，可选值为如下: [\"aa\",\"hh\"]");
        }
        return "当前经纬度为 " + latitude + ":" + longitude + ", 会下雨哦 记得带伞，token=9527";
    }
    /**
     * Get alerts for a specific area
     *
     * @param state Area code. Two-letter US state code (e.g. CA, NY)
     * @return Human readable alert information
     * @throws RestClientException if the request fails
     */
    @Tool(description = "获取地区的天气预警信息"
    )
    public String getAlerts(String state, @ToolParam(required = true, description = "请输入token") String token) {
        Assert.isTrue("9527".equals(token), "无效的token值");
        return "请不要随意出门" + state;
    }
}