Springboot MCPserver JUnit

🚀 Springboot + MCP + JUnit 项目模板

本项目模板可使用 Springboot 快速构建一个 MCP 项目，并且支持 JUNIT 单元测试。模式支持 STDIO 和 SSE，为开发提供了更多选择。

🚀 快速开始

开发环境

• 开发 IDE：IDEA
• Java 版本：JAVA17（Spring 官方要求必须 Java17+）
• Maven 版本：3.8.1（太高引入项目时可能报错，请选择适当版本）

参考文档资料

1. MCP 官网 - 协议（必读文档）
2. MCP 官网 - 编码指南
3. Spring 官网

解说视频

• 全网首发：从零搭建 Springboot+MCP+JUnit 项目 【搭配 CherryStudio】BV1qUXkYRE6C
• 全网首发：Springboot+MCP(SSE)+JUnit 从搭建到上线 BV1rSXWYGEVz

📚 详细文档

客户端测试方案

1. 对于 STDIO 客户端配置方式

命令(Command):
    java
参数(Arguments):
    -jar
    -Dfile.encoding=UTF-8
    -Dspring.ai.mcp.server.stdio=true
    AbsolutePath/**/xxx.jar
环境(Environments):
    env1=xxx
    env2=yyy

⚠️ 重要提示

指令是 java（如果本地主环境不是 17+，注意切换）；参数 file.encoding 指定 System.in 和 System.out 为 UTF - 8 编码，避免编码问题；参数 spring.ai.mcp.server.stdio 表示以 stdio 的方式启用该服务；环境配置，是将配置写入当前系统环境，以供当前程序调取。

2. 对于 SSE 客户端配置方式

SSE地址填写如下链接即可：
http://主机地址:端口/sse

额外可选功能的探索

1. 修改消息端点

配置文件参见：McpServerProperties

spring.ai.mcp.server.sseMessageEndpoint=/mcp/message

2. 修改 sse 端点

原始的 sse 端点在 /sse，而配置文件没有提供 sse 端点的配置方式，所以需要重新注入 ServerMcpTransport 来换掉原来的。

⚠️ 重要提示

注意下面两个 Bean 配置都要加，因为自动注入文件 MpcWebMvcServerAutoConfiguration 中，对整个注册的注入条件是 @ConditionalOnMissingBean(ServerMcpTransport.class)，导致下面两个 bean 都不会注入。

private final String SSE_ENDPOINT = "/sse";

@Bean
@ConditionalOnMissingBean
public WebMvcSseServerTransport webMvcSseServerTransport(ObjectMapper objectMapper,
        McpServerProperties serverProperties) {
    return new WebMvcSseServerTransport(objectMapper, serverProperties.getSseMessageEndpoint(), SSE_ENDPOINT);
}

@Bean
public RouterFunction<ServerResponse> mvcMcpRouterFunction(WebMvcSseServerTransport transport) {
    return transport.getRouterFunction();
}

3. 一服务多端点？

需要重新注入多个 McpSyncServer，详见类 MpcServerAutoConfiguration 。

💡 使用建议

因为多端点可能会涉及到的东西非常多，感兴趣的可以自己研究。

4. SSE 授权？

在 2025.03.26 的 MCP 官方协议文档中，更新了鉴权方案，期待 Spring 的更新。