SpringBoot MCP 入门使用

最新推荐文章于 2025-04-12 22:51:59 发布

cmlbeliever

最新推荐文章于 2025-04-12 22:51:59 发布

阅读量2.4k

点赞数 7

本文链接：https://blog.csdn.net/cml_blog/article/details/146284656

版权

随着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;
    }


}

第三步启动服务

第四步配置cursor

这里使用cursor作为mcp client，在设置中添加上这里添加的mcp工具，这里选择的是sse协议
在这里插入图片描述
选择完成后，看到天气左边的小绿点表示连接成功了

第五步使用

这里就按照正常的咨询场景，问一下杭州的天气，大模型就会根据当前的mcp server工具和需要的入参进行判断，发现天气这个server入参需要经纬度信息，于是就会自动获取城市对应的经纬度信息，并且调用天气这个mcp工具
在这里插入图片描述
在程序上我们写死了expectValue可选值为aa和hh，当第一次获取失败时会自动替换下一个值

!](https://i-blog.csdnimg.cn/direct/df393162d6934a58a0a8debc666a5892.png)