Spring AI MCP Server SSE端点访问问题分析与解决方案

问题背景

在使用Spring AI框架实现MCP Server时，开发者遇到了一个常见但令人困扰的问题：当采用SSE(Server-Sent Events)方式实现服务时，虽然服务能够正常启动，但无法通过浏览器或Postman访问/sse端点。这个问题在社区中引起了广泛讨论，多个开发者都报告了类似现象。

问题现象

开发者配置了Spring AI MCP Server后，服务启动日志显示正常，但访问localhost:8080/sse端点时却得不到任何响应。控制台也没有报错信息，使得问题排查变得困难。这种情况在使用不同版本依赖时表现有所不同，特别是当混合使用不同版本的Spring AI依赖时问题更为明显。

根本原因分析

经过社区多位开发者的验证和讨论，发现这个问题的根源在于依赖选择和配置的不匹配：

1. 依赖冲突：同时引入webmvc和webflux两种实现会导致冲突
2. 配置缺失：使用webflux实现时缺少必要的响应式配置
3. 版本不兼容：不同版本间的行为差异导致端点注册失败

解决方案

方案一：使用WebMVC实现

这是目前最稳定的解决方案，适用于大多数场景：

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
</dependency>

此方案简单直接，不需要额外配置，适合不需要响应式编程特性的项目。

方案二：正确配置WebFlux实现

如果项目确实需要响应式特性，可以采用以下配置：

1. 确保只引入webflux依赖：

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-starter-mcp-server-webflux</artifactId>
</dependency>

2. 在配置文件中明确指定应用类型：

spring:
  main:
    web-application-type: reactive

3. 完整配置示例：

spring.ai.mcp.server.enabled=true
spring.ai.mcp.server.stdio=false
spring.ai.mcp.server.type=ASYNC
spring.ai.mcp.server.sse-message-endpoint=/mcp/messages
spring.ai.mcp.server.sse-endpoint=/sse
spring.ai.mcp.server.capabilities.tool=true

注意事项

1. 依赖管理：确保使用统一的版本管理，避免混合不同版本的依赖
2. 配置一致性：配置属性需要与选择的实现方式匹配
3. 兼容性问题：注意webflux实现可能与其他阻塞式组件(如OpenFeign)不兼容
4. 日志检查：服务启动时应检查是否有端点注册成功的日志

最佳实践建议

1. 对于新项目，如果不需要响应式特性，优先选择webmvc实现
2. 如果项目中已经使用了webflux技术栈，再考虑使用webflux实现
3. 保持依赖版本统一，避免混合使用不同版本的Spring AI组件
4. 在配置文件中明确指定所有必要的属性，避免依赖默认值

总结

Spring AI MCP Server的SSE端点访问问题主要源于实现方式的选择和配置。通过正确选择依赖和配置，可以轻松解决这个问题。对于大多数应用场景，使用webmvc实现是最简单可靠的方案；而对于需要响应式特性的项目，则需要额外配置web-application-type为reactive。开发者应根据项目实际需求选择适合的方案。