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 的更新。