mcp - sse、streamable 和 stdio 的区别？

三种传输方式（sse、streamable 和 stdio ），streamable 还有无状态的 streamable_stateless。可归为两大类：

• http（sse、streamable、streamable_stateless和），远程通讯
• stdio，进程通讯

具体对比说明（区别）：

有会话状态？

• 可以支持反向通讯（server -> client：发通知、采样）

sse 和 streamable 有什么不同？

• 都用到了 http sse。
• sse 需要两个端点（uri path）。一般配置一个，另一个自动生成。
• streamable 协议内部采用了流式传输，用于替代 sse。（这个流式传输与应用接口开发无关）
• streamable 在 server 侧，支持 stateless 模式（无会话状态，无长链接，集群友好）。

solon mcp 开发时的体验都是一致的，主要是 channel （通讯方式）配置不同。

1、构建 stdio 服务端点参考

一个进程内只能有一个 stdio 服务端点，且 server 侧不能启用控制台日志（否则会协议串流）。

import org.noear.solon.ai.annotation.ToolMapping;
import org.noear.solon.ai.mcp.McpChannel;
import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
import org.noear.solon.annotation.Param;

@McpServerEndpoint(channel = McpChannel.STDIO) //表示使用 stdio
public class McpServerTool {
    @ToolMapping(description = "查询天气预报")
    public String get_weather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}

2、构建 http 服务端点参考（sse、streamable、streamable_stateless）

sse、streamable、streamable_stateless 者是构建在 http 协议的基础上。开发体验类似 web mvc，配置服务端点的 mcpEndpoint 属性即可。

import org.noear.solon.ai.annotation.ToolMapping;
import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
import org.noear.solon.annotation.Param;

@McpServerEndpoint(channel = McpChannel.STREAMABLE, mcpEndpoint = "/mcp/case1") 
public class McpServerTool1 {
    @ToolMapping(description = "查询天气预报")
    public String getWeather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}

@McpServerEndpoint(channel = McpChannel.STREAMABLE_STATELESS, mcpEndpoint = "/mcp/case2") 
public class McpServerTool2 {
    @ToolMapping(description = "查询天气预报")
    public String getWeather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}

@McpServerEndpoint(channel = McpChannel.SSE, mcpEndpoint = "/mcp/case3") 
public class McpServerTool3 {
    @ToolMapping(description = "查询天气预报")
    public String getWeather(@Param(description = "城市位置") String location) {
        return "晴，14度";
    }
}