v3.8.0 后支持：MCP 反向通讯，即服务器发起的请求 (Server-initiated requests)。主要有两种：

* 变更通知，比如：tool 变更（框架内自动处理）
* 反向请求，比如：sampling、roots 请求


提醒：当 server 使用 STREAMABLE_STATELESS 方式时。不支持反向通讯。

### 1、反向请求 (Server-initiated requests)

反向请求这个需求场景较少。Solon MCP 直接采用 SDK 接口的体验方式，只支持响应式接口（projectreactor）。


Sampling (采样)

* 当 MCP Server 正在执行某项任务，发现需要 LLM（大语言模型）提供进一步的推理、解释或决策时，它可以向 Client 发起一个采样请求。


Roots (根目录访问)

* 除了 Sampling，MCP 还支持 Roots List 的反向获取。 Server 可以请求 Client 提供当前用户授权访问的目录列表（Roots）。这同样属于 Server 向 Client 主动获取信息的一种“反向”行为。


### 2、Sampling 示例

* 客户端

```java
public class SamplingClientDemo {
    public void test() {
        McpClientProvider clientProvider = McpClientProvider.builder()
                .url("http://localhost:8080/mcp")
                .customize(spec -> {
                    spec.capabilities(McpSchema.ClientCapabilities.builder().sampling().build());
                    spec.sampling(req -> Mono.just(McpSchema.CreateMessageResult.builder()
                            .content(new McpSchema.TextContent("test"))
                            .build()));
                })
                .build();


        clientProvider.callTool("demo", Utils.asMap("a", 1))
                .getContent();
    }
}
```



* 服务端（只是示意下）

```java
@McpServerEndpoint(channel = McpChannel.STREAMABLE, mcpEndpoint = "/mcp")
public class SamplingServerDemo {
    @ToolMapping(description = "demo")
    public Mono<McpSchema.CreateMessageResult> demo(McpAsyncServerExchange exchange) {
        return exchange.createMessage(McpSchema.CreateMessageRequest.builder().build());
    }
}
```