协议初始化

创建客户端后，应在发送其他协议请求前调用 initialize()。该方法会启动传输层、协商协议版本和能力，并发送 notifications/initialized 通知。

Initialize 方法的步骤如下：

1. 向服务器发送初始化请求
2. 记录服务器返回的初始化结果
3. 发送 “initialized” 通知

初始化成功后，客户端才能向服务器发起其他请求。

服务端会在协议协商前校验 initialize 报文：params 和 capabilities 必须是 JSON object；protocolVersion、 clientInfo.name 与 clientInfo.version 必须是非空字符串。客户端输入不合法时返回 JSON-RPC INVALID_PARAMS，而不是 internal error。

客户端能力必须在调用 initialize() 前注册。例如，应先调用 setRoots(...)、setSamplingHandler(...) 或 setElicitationHandler(...)；只有已注册 handler 的能力才会被声明。服务端对未声明 Roots 或 Sampling 能力的 session 发起相应请求时，会在本地直接拒绝。

因此，构建 McpClient 后应立即调用 initialize()。初始化遵循 requestTimeout 配置；设置为 0 时表示无限等待。

McpClient mcpClient = McpClient.builder()
        .clientName("my-host")
        .clientVersion("1.2")
        .transport(sseTransport)
        .build();

mcpClient.initialize();