原生Java SDK实现MCP Server（基于WebMvc的SSE通信方式）

前言

看了第一小节如何通过Servlet实现MCP Server SSE的方式，我们接下来在此基础上，通过web mvc的方式来实现同样的功能。

环境要求

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

引入依赖

新建一个Springboot项目，目前Springboot最高版本是3.4.5，当前demo在3.0.0或以上都支持，并新增以下依赖。注意版本，截止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-webmvc</artifactId>  
	</dependency>
</dependencies>

mcp-spring-webmvc是MCP官方针对spring mvc做的适配方案，适用于spring mvc项目集成MCP功能。

业务代码

我们依然使用上一节的OrderService作为我们这次示例的业务代码，通过订单号获取订单详情：

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配置

因为我们这次是在Spring mvc的基础上集成mcp server，所以下面的配置和上一节Servlet的配置有所不同：

java 复制代码

import com.fasterxml.jackson.databind.ObjectMapper;
import io.modelcontextprotocol.server.transport.WebMvcSseServerTransportProvider;
import org.springframework.context.annotation.Bean;  
import org.springframework.context.annotation.Configuration;  
import org.springframework.web.servlet.config.annotation.EnableWebMvc;  
import org.springframework.web.servlet.function.RouterFunction;  
import org.springframework.web.servlet.function.ServerResponse;

@Configuration  
@EnableWebMvc  
public class McpConfig {  
	@Bean  
	WebMvcSseServerTransportProvider webMvcSseServerTransportProvider(ObjectMapper mapper) {  
		return new WebMvcSseServerTransportProvider(mapper, "/mcp/message");  
	}  
  
	@Bean  
	RouterFunction<ServerResponse> mcpRouterFunction(WebMvcSseServerTransportProvider transportProvider) {  
		return transportProvider.getRouterFunction();  
	}
}

WebMvcSseServerTransportProvider是基于Spring mvc基础上实现了SSE通信方式，RouterFunction作用和ServletRegistrationBean类似，它里面针对/sse、/mcp/message请求做了路由处理，把这类请求都交给了WebMvcSseServerTransportProvider处理；

剩下的就是我们配置一个McpSyncServer Bean对象，并把需要暴露的业务接口配置到Tools里面去：

java 复制代码

@Bean(destroyMethod = "close")  
public McpSyncServer mcpSyncServer(WebMvcSseServerTransportProvider transportProvider,  
OrderService orderService) {  
	McpSyncServer mcpSyncServer = McpServer.sync(transportProvider)  
	.serverInfo("my-server", "1.0.0")  
	.capabilities(McpSchema.ServerCapabilities.builder()  
		.tools(true) // Enable tool support  
		.logging() // Enable logging support  
		.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;  
}

我们在创建McpSyncServer时和上一小节的区别就是更换了transportProvider，之前使用的是HttpServletSseServerTransportProvider创建McpSyncServer，此次更换成使用WebMvcSseServerTransportProvider创建McpSyncServer，虽然本质上实现原理都一样，但是基于的框架是不同的，HttpServletSseServerTransportProvider的实现只依赖于Servlet，不需要Spring框架来支撑，而WebMvcSseServerTransportProvider是基于Spring mvc框架实现的。

测试

我们的测试方式完全可以参考上一小节使用cherry studio作为MCP Client验证，可按照以下图示进行配置：

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