快捷導(dǎo)航

SpringBoot改造MCP服務(wù)器的詳細(xì)說明(StreamableHTTP 類型)

更新時(shí)間：2025年07月18日 11:53:54 作者：kylewka

本文介紹了SpringBoot如何實(shí)現(xiàn)MCP StreamableHTTP 服務(wù)器,并且使用Cherry Studio 客戶端測(cè)試MCP服務(wù)器,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友參考下吧

SpringBoot改造MCP服務(wù)器（StreamableHTTP）

1 項(xiàng)目說明

MCP（Model Context Protocol）協(xié)議是一個(gè)用于 AI 模型和工具之間通信的標(biāo)準(zhǔn)協(xié)議。隨著 AI 應(yīng)用變得越來(lái)越復(fù)雜并被廣泛部署，原有的通信機(jī)制面臨著一系列挑戰(zhàn)。

近期 MCP 倉(cāng)庫(kù)的 PR #206【1】引入了一個(gè)全新的 Streamable HTTP 傳輸層替代原有的 HTTP+SSE 傳輸層

Streamable HTTP 相比 HTTP + SSE 具有更好的穩(wěn)定性，在高并發(fā)場(chǎng)景下表現(xiàn)更優(yōu)。
Streamable HTTP 在性能方面相比 HTTP + SSE 具有明顯優(yōu)勢(shì)，響應(yīng)時(shí)間更短且更穩(wěn)定。
Streamable HTTP 客戶端實(shí)現(xiàn)相比 HTTP + SSE 更簡(jiǎn)單，代碼量更少，維護(hù)成本更低。

本文介紹了SpringBoot如何實(shí)現(xiàn)MCP StreamableHTTP 服務(wù)器，并且使用 Cherry Studio 客戶端測(cè)試MCP服務(wù)器

Streamable HTTP 支持無(wú)狀態(tài)的服務(wù)和有狀態(tài)的服務(wù)，目前的大部分場(chǎng)景無(wú)狀態(tài)的 Streamable HTTP 的可以解決，通過對(duì)比兩種傳輸方案的客戶端實(shí)現(xiàn)代碼，可以直觀地看到無(wú)狀態(tài)的 Streamable HTTP 的客戶端實(shí)現(xiàn)簡(jiǎn)潔性。

由于官方的 mcp-java-sdk 還未支持 StreamableHTTP 模式，同時(shí)需要研究以原有項(xiàng)目提供MCP服務(wù)，故設(shè)計(jì)了該項(xiàng)目

項(xiàng)目已經(jīng)封裝為 springboot 的 starter 組件，僅需添加幾個(gè)注解就能實(shí)現(xiàn)MCP服務(wù)器方法

項(xiàng)目地址： https://gitee.com/kylewka/smart-ai

2 使用說明

2.1 安裝教程

確保您的開發(fā)環(huán)境已安裝 JDK 8 或更高版本以及 Maven
克隆本倉(cāng)庫(kù)到本地：git clone https://gitee.com/kylewka/smart-ai.git?
進(jìn)入項(xiàng)目根目錄，執(zhí)行 Maven 構(gòu)建命令：mvn clean install?

2.2 添加依賴

在您的 Spring Boot 項(xiàng)目的 pom.xml? 文件中添加以下依賴

該依賴暫未發(fā)布到 Maven 倉(cāng)庫(kù)，需要手動(dòng)安裝至本地倉(cāng)庫(kù)

<dependency>
    <groupId>com.github.kylewka</groupId>
    <artifactId>smart-ai-mcp-spring-boot-starter</artifactId>
    <version>1.0.0</version>
</dependency>

2.3 創(chuàng)建 MCP 服務(wù)端點(diǎn)

使用 @McpServerEndpoint 注解標(biāo)注您的服務(wù)類，并使用 @McpFunction 注解標(biāo)注服務(wù)方法

@McpServerEndpoint(value = "/mcp", version = "1.0.0", name = "測(cè)試MCP服務(wù)")
public class McpServerTool {
    @McpFunction(name = "getWeather", description = "獲取天氣信息")
    public String getWeather(@McpParam(name = "city", description = "城市名稱", required = true) String city) {
        return String.format("%s: 晴天，溫度25℃", city);
    }
    @McpFunction(name = "getSpeciality", description = "獲取城市特產(chǎn)")
    public String getSpeciality(@McpParam(name = "city", description = "城市名稱", required = true) String city) {
        return String.format("%s特產(chǎn)是小籠包", city);
    }
}

2.4 啟動(dòng)應(yīng)用

直接啟動(dòng) Spring Boot 啟動(dòng)，即可啟動(dòng)MCP服務(wù)

MCP服務(wù)受項(xiàng)目本身的鑒權(quán)系統(tǒng)影響，請(qǐng)根據(jù)實(shí)際情況進(jìn)行配置

客戶端使用

使用新版MCP協(xié)議的客戶端軟件 Cherry Studio，建議使用 Cherry Studio >= 1.2.0

客戶端設(shè)置中添加MCP服務(wù)器

配置模型并選擇MCP服務(wù)器

對(duì)話測(cè)試效果

到此這篇關(guān)于SpringBoot改造MCP服務(wù)器的詳細(xì)說明(StreamableHTTP 類型)的文章就介紹到這了,更多相關(guān)SpringBoot MCP服務(wù)器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: