快捷導(dǎo)航

SpringBoot?MCP?入門使用步驟詳解

更新時間：2025年04月01日 16:45:48 作者：cmlbeliever

這篇文章主要介紹了SpringBoot?MCP?入門使用,本文分步驟給大家介紹的非常詳細,需要的朋友可以參考下

隨著AI的火爆，最近發(fā)現(xiàn)MCP在未來確實大有可為，作為一名javaer怎么可以落后在歷史洪流呢，根據(jù)官網(wǎng)和cursor也從零開始體驗一下自定義mcp server。以后可以根據(jù)自己業(yè)務(wù)場景做出各種適合自身業(yè)務(wù)的工具。
至于什么是MCP 可以到https://modelcontextprotocol.io/introduction看看，里面有非常詳細的介紹，這里就不贅述了。
下面開始我們自己的第一個mcp server，按照各種demo 我這里也以獲取當(dāng)前天氣和報警信息作為demo，這里會提供兩個工具：

根據(jù)經(jīng)緯度獲取天氣，獲取天氣后會返回一個token信息
根據(jù)token信息獲取天氣報警

那下面開始我們的開發(fā)

第一步初始化pom

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

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

第二步編寫tools

getWeatherForecastByLocation：這里也是根據(jù)官方demo信息進行稍微改造，在獲取天氣的時候除了經(jīng)緯度入?yún)⑼?，還需要傳入一個期望值，這個值可選范圍為aa和hh，主要是mock一些業(yè)務(wù)場景下入?yún)⑹敲杜e類型的場景。
getAlerts：模擬業(yè)務(wù)場景中有流程上數(shù)據(jù)依賴的場景，這里的token入?yún)⑿畔⑹菑牡谝徊街蝎@取的

@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 = "根據(jù)經(jīng)緯度獲取當(dāng)前天氣，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 "當(dāng)前經(jīng)緯度為 " + 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 = "獲取地區(qū)的天氣預(yù)警信息"
    )
    public String getAlerts(String state, @ToolParam(required = true, description = "請輸入token") String token) {
        Assert.isTrue("9527".equals(token), "無效的token值");
        return "請不要隨意出門" + state;
    }
}

第三步啟動服務(wù)

第四步配置cursor

這里使用cursor作為mcp client，在設(shè)置中添加上這里添加的mcp工具，這里選擇的是sse協(xié)議

選擇完成后，看到天氣左邊的小綠點表示連接成功了

第五步使用

這里就按照正常的咨詢場景，問一下杭州的天氣，大模型就會根據(jù)當(dāng)前的mcp server工具和需要的入?yún)⑦M行判斷，發(fā)現(xiàn)天氣這個server入?yún)⑿枰?jīng)緯度信息，于是就會自動獲取城市對應(yīng)的經(jīng)緯度信息，并且調(diào)用天氣這個mcp工具