原生Java SDK实现MCP Server(基于WebFlux的SSE通信方式)

前言

MCP官方除了为Spring mvc定制sdk,另外还为响应式编程的WebFlux定制了对应的sdk,以便使用Spring WebFlux的项目也能很方便地接入MCP服务。下面我们就快速开始,看看如何在Spring WebFlux项目中接入MCP Server吧。

环境要求

工具 版本
JDK 17或以上
SpringBoot 3.0或以上
Tomcat 10或以上
Maven 3.8.3+,最好是3.9.x

引入依赖

我们依然还是先创建一个最基本的SpringBoot项目,然后在此基础上新增以下依赖。注意版本,截止2025-04-30,MCP Java SDK最新版本为0.9.0:

xml 复制代码
<dependencyManagement>  
    <dependencies>  
        <dependency>  
            <groupId>io.modelcontextprotocol.sdk</groupId>  
            <artifactId>mcp-bom</artifactId>  
	        <version>0.9.0</version>  
	        <type>pom</type>  
	        <scope>import</scope>  
	    </dependency>  
    </dependencies>  
</dependencyManagement>

<dependencies>
    <dependency>  
	    <groupId>io.modelcontextprotocol.sdk</groupId>  
		<artifactId>mcp-spring-webflux</artifactId>  
	</dependency>
</dependencies>

注意:如果依赖中有spring-boot-starter-web依赖,需要更换成spring-boot-starter-webflux:

xml 复制代码
<dependency>  
	<groupId>org.springframework.boot</groupId>  
	<artifactId>spring-boot-starter-webflux</artifactId>  
</dependency>

另外就是需要把@EnableWebMvc去掉,开启@EnableWebFlux,避免服务启动后产生404错误;

业务代码

目前在这几个demo当中,我们使用的业务代码都是同一套,通过订单号获取订单详情:

java 复制代码
import org.springframework.stereotype.Service;

@Service
public class OrderService {

	public OrderDetail getOrderDetail(String orderId) {  
		OrderDetail orderDetail = new OrderDetail();  
		orderDetail.setOrderId(orderId);
		orderDetail.setDetail("订单详情");
		return orderDetail;  
	}

	public static class OrderDetail {  
		private String orderId;  
		  
		private String detail;  
		  
		public void setOrderId(String orderId) {  
			this.orderId = orderId;  
		}  
		  
		public String getOrderId() {  
			return this.orderId;  
		}  
		  
		public void setDetail(String detail) {  
			this.detail = detail;  
		}  
		  
		public String getDetail() {  
			return this.detail;  
		}  
		@Override  
		public String toString() {  
			return "{\"orderId\":\"" + this.orderId + "\",\"detail\":\"" + this.detail+ "\"}";  
		}
	}
}

编写MCP Server配置

1、首先我们依然是配置SSE的通信方式,这个取决于TransportProvider,WebFlux的实现类是WebFluxSseServerTransportProvider,并且通过新增RouterFunction把/sse、/mcp/message请求交给WebFluxSseServerTransportProvider处理:

java 复制代码
import com.fasterxml.jackson.databind.ObjectMapper;
import io.modelcontextprotocol.server.transport.WebFluxSseServerTransportProvider;
import org.springframework.context.annotation.Bean;  
import org.springframework.context.annotation.Configuration;  
import org.springframework.web.reactive.config.EnableWebFlux;  
import org.springframework.web.reactive.function.server.RouterFunction;

@EnableWebFlux  
@Configuration  
class McpConfig {  
	@Bean  
	WebFluxSseServerTransportProvider webFluxSseServerTransportProvider(ObjectMapper mapper) {  
		return new WebFluxSseServerTransportProvider(mapper, "/mcp/message");  
	}  
  
	@Bean  
	RouterFunction<?> mcpRouterFunction(WebFluxSseServerTransportProvider transportProvider) {  
		return transportProvider.getRouterFunction();  
	}
}

2、接下来依然还是配置McpSyncServer对象,这次传入的TransportProvider对象是WebFluxSseServerTransportProvider:

java 复制代码
@Bean(destroyMethod = "close")  
public McpSyncServer mcpSyncServer(WebFluxSseServerTransportProvider transportProvider,  
OrderService orderService) {  
	McpSyncServer mcpSyncServer = McpServer.sync(transportProvider)  
	.serverInfo("my-server", "1.0.0")  
	.capabilities(McpSchema.ServerCapabilities.builder() 
		.tools(true)
		.build())  
	.build();  
	  
	String jsonSchema = """  
	{  
		"type":"object",  
		"properties":{  
			"orderId" : {  
				"type": "string",  
				"description": "订单号"  
			}  
		},  
		"required":[  
			"orderId"  
		],  
		"additionalProperties":false  
	}  
	""";  
	// 方法的描述  
	McpSchema.Tool tool = new McpSchema.Tool("getOrderDetail", "通过订单号获取订单详情信息", jsonSchema);  
	// 方法描述对应的执行逻辑  
	BiFunction<McpSyncServerExchange, Map<String, Object>, McpSchema.CallToolResult> call = (exchange, arguments) -> {  
	OrderService.OrderDetail result = orderService.getOrderDetail(String.valueOf(arguments.get("orderId")));  
	return new McpSchema.CallToolResult(result.toString(), false);  
	};  
	// 绑定描述和执行逻辑  
	McpServerFeatures.SyncToolSpecification toolHandler = new McpServerFeatures.SyncToolSpecification(tool, call);  
	  
	// 添加到工具集中  
	mcpSyncServer.addTool(toolHandler);  
	  
	return mcpSyncServer;  
}

测试

现在我们所有的代码都编写完毕,接下来依然通过cherry studio作为MCP Client验证,可按照以下图示进行配置:

如果按照上述图示配置没有异常,那么说明MCP Server启动成功,且能正常提供服务,并且可在工具栏看到我们暴露出来的接口:

相关推荐
iナナ3 分钟前
初识JVM
java·jvm
m0_5704664113 分钟前
代码随想录算法训练营第二十八天 | 买卖股票的最佳实际、跳跃游戏、K次取反后最大化的数组和
java·开发语言·算法
ST.J1 小时前
swing笔记
java·笔记
菩提树下的凡夫1 小时前
瑞芯微RV1126目标识别算法Yolov8的部署应用
java·算法·yolo
尚学教辅学习资料1 小时前
Ruoyi-vue-plus-5.x第五篇Spring框架核心技术:5.1 Spring Boot自动配置
vue.js·spring boot·spring
爱隐身的官人1 小时前
新后端漏洞(上)- Java RMI Registry反序列化漏洞
java·反序列化漏洞
叫我阿柒啊1 小时前
从Java全栈到前端框架:一次真实的面试对话与技术解析
java·javascript·typescript·vue·springboot·react·前端开发
晚安里2 小时前
Spring 框架(IoC、AOP、Spring Boot) 的必会知识点汇总
java·spring boot·spring
爱隐身的官人2 小时前
新后端漏洞(上)- Aapache Tomcat AJP 文件包含漏洞(CVE-2020-1938)
java·tomcat·ajp
@CLoudbays_Martin112 小时前
为什么动态视频业务内容不可以被CDN静态缓存?
java·运维·服务器·javascript·网络·python·php