java springboot实现MCP Server SSE

参考：

https://juejin.cn/post/7491881721278529570

SpringAI 实现 SSE MCP Server项目 - Auler - 博客园

springboot-MCPserver-JUnit: 使用springboot支持mcp项目搭建，同时有着便捷的单元测试来进行敏捷开发对话即服务：Spring Boot+MCP让你的CRUD系统秒变AI助手 - 雨梦山人 - 博客园

java的jdk使用17，可参考：Java 17 Windows 安装教程--保姆级安装_java17-CSDN博客

java的mcp-server依赖使用1.0.0-M8，可参考：

MCP Server Boot Starter :: Spring AI Reference

Spring AI版本1.0.0-M6和M8效果比较-CSDN博客

本文使用了两种mcp client：cherry studio和cursor

源代码参考：我的/springboot-mcpserver-demo

代码片段

pom.xml

    4.0.0
    
        org.springframework.boot
        spring-boot-starter-parent
        3.4.3
         
    
    top.dreamcenter
    mcp
    1.0.0-SNAPSHOT
    mcp
    Template project for SpringBoot + MCP
    
        17
    
    
        
            org.springframework.boot
            spring-boot-starter-test
            test
        
        
            org.springframework.boot
            spring-boot-starter-web
            
        
        
            org.springframework.ai
            spring-ai-starter-mcp-server-webmvc
            1.0.0-M8
        
    
    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
                
                    top.dreamcenter.mcp.McpApplication
                
                
                    
                        
                            repackage
                        
                    
                
            
        
    

McpApplication.java

package top.dreamcenter.mcp;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class McpApplication {
    public static void main(String[] args) {
        SpringApplication.run(McpApplication.class, args);
    }
}

NumService.java

package top.dreamcenter.mcp.service;
import org.springframework.ai.tool.annotation.Tool;
import org.springframework.ai.tool.annotation.ToolParam;
import org.springframework.stereotype.Service;
@Service
public class NumService {
    @Tool(description = "判断是否是双数")
    public String judgeIfOddJava(@ToolParam(description = "待判断的数") Integer num) {
        return num + (num%2 == 0 ? "是双数" : "不是双数");
    }
}

ToolCallbackProviderRegister.java

package top.dreamcenter.mcp.config;
import org.springframework.ai.tool.ToolCallbackProvider;
import org.springframework.ai.tool.method.MethodToolCallbackProvider;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import top.dreamcenter.mcp.service.NumService;
@Configuration
public class ToolCallbackProviderRegister {
    @Bean
    public ToolCallbackProvider numTools(NumService numService) {
        return MethodToolCallbackProvider.builder().toolObjects(numService).build();
    }
}

NumController.java

package top.dreamcenter.mcp.controller;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import top.dreamcenter.mcp.service.NumService;
@RestController
@RequestMapping("/api/num")
public class NumController {
    @Autowired
    private NumService numService;
    @GetMapping("/judge/{num}")
    public String judgeIfOddJava(@PathVariable Integer num) {
        return numService.judgeIfOddJava(num);
    }
    
} 

cherry studio效果

​

cursor效果

单独通过url请求http://localhost:8000/sse端口的响应内容如下

MCP工具接口和RESTful接口

我们可以在同一个应用程序中同时提供MCP工具接口和RESTful接口。

MCP工具接口 - 通过@Tool注解在Service层提供AI工具能力

RESTful API接口 - 通过Controller层提供常规Web API访问

​

这样设计的优势：

对于AI应用（如Claude这样的大模型），可以通过MCP接口直接调用您的服务功能

对于传统Web应用，可以通过RESTful API接口访问相同的功能

共享相同的业务逻辑层（Service层），减少代码重复