SpringBoot改造MCP服务器(StreamableHTTP)

项目地址: https://gitee.com/kylewka/smart-ai

1 项目说明

MCP(Model Context Protocol)协议是一个用于 AI 模型和工具之间通信的标准协议。随着 AI 应用变得越来越复杂并被广泛部署,原有的通信机制面临着一系列挑战。

近期 MCP 仓库的 PR #206【1】 引入了一个全新的 Streamable HTTP 传输层替代原有的 HTTP+SSE 传输层

Streamable HTTP 相比 HTTP + SSE 具有更好的稳定性,在高并发场景下表现更优。

Streamable HTTP 在性能方面相比 HTTP + SSE 具有明显优势,响应时间更短且更稳定。

Streamable HTTP 客户端实现相比 HTTP + SSE 更简单,代码量更少,维护成本更低。

本文介绍了SpringBoot如何实现MCP StreamableHTTP 服务器,并且使用 Cherry Studio 客户端测试MCP服务器

Streamable HTTP 支持无状态的服务和有状态的服务,目前的大部分场景无状态的 Streamable HTTP 的可以解决,通过对比两种传输方案的客户端实现代码,可以直观地看到无状态的 Streamable HTTP 的客户端实现简洁性。

由于官方的 mcp-java-sdk 还未支持 StreamableHTTP 模式,同时需要研究以原有项目提供MCP服务,故设计了该项目

项目已经封装为 springboot 的 starter 组件,仅需添加几个注解就能实现MCP服务器方法

项目地址: https://gitee.com/kylewka/smart-ai

2 使用说明

2.1 安装教程

确保您的开发环境已安装 JDK 8 或更高版本以及 Maven

克隆本仓库到本地:git clone https://gitee.com/kylewka/smart-ai.git​

进入项目根目录,执行 Maven 构建命令:mvn clean install​

2.2 添加依赖

在您的 Spring Boot 项目的 pom.xml​ 文件中添加以下依赖

该依赖暂未发布到 Maven 仓库,需要手动安装至本地仓库
com.github.kylewka smart-ai-mcp-spring-boot-starter 1.0.0

2.3 创建 MCP 服务端点

使用 @McpServerEndpoint 注解标注您的服务类,并使用 @McpFunction 注解标注服务方法

@McpServerEndpoint(value = "/mcp", version = "1.0.0", name = "测试MCP服务")

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 = "获取城市特产")
public String getSpeciality(@McpParam(name = "city", description = "城市名称", required = true) String city) {
    return String.format("%s特产是小笼包", city);
}

}

2.4 启动应用

直接启动 Spring Boot 启动,即可启动MCP服务

MCP服务受项目本身的鉴权系统影响,请根据实际情况进行配置

客户端使用

使用新版MCP协议的客户端软件 Cherry Studio,建议使用 Cherry Studio >= 1.2.0

相关推荐
算家计算3 分钟前
OpenAI推出首款浏览器,能否撼动全球超30亿用户的Chrome?
人工智能·openai·资讯
文火冰糖的硅基工坊4 分钟前
[人工智能-大模型-33]:模型层技术 - 大模型的神经网络架构
人工智能·神经网络·架构
文火冰糖的硅基工坊21 分钟前
[人工智能-大模型-33]:模型层技术概览 - 大模型内部组成与层次调用关系
人工智能
Python算法实战35 分钟前
平安大模型面试题:Self-Attention 原理与多头注意力设计
人工智能·算法·自然语言处理·大模型·面试题
安於宿命36 分钟前
【machine learning】COVID-19 daily cases prediction
人工智能·机器学习
后端小肥肠1 小时前
【n8n入门系列】3 种方法搞定 n8n 生图!最多3步,小白也能学会的自动化教程
人工智能·openai·agent
Python算法实战1 小时前
腾讯送命题:手写多头注意力机制。。。
人工智能·算法·面试·大模型·强化学习
Rock_yzh1 小时前
AI学习日记——PyTorch深度学习快速入门:神经网络构建与训练实战
人工智能·pytorch·python·深度学习·神经网络·学习
razelan2 小时前
第一例:石头剪刀布的机器学习(xedu,示例15)
人工智能·机器学习
一条星星鱼2 小时前
从0到1:如何用统计学“看透”不同睡眠PSG数据集的差异(域偏差分析实战)
人工智能·深度学习·算法·概率论·归一化·睡眠psg