从源码看MCP Java SDK，这里面究竟定义了啥样的协议

io.modelcontextprotocol.spec
├── McpSchema.java          // 协议数据模型定义
├── McpSession.java         // 会话接口定义  
├── McpTransport.java       // 传输层抽象接口
├── ClientMcpTransport.java // 客户端传输接口
├── ServerMcpTransport.java // 服务端传输接口
├── DefaultMcpSession.java  // 默认会话实现
└── McpError.java          // 错误处理
1.
2.
3.
4.
5.
6.
7.
8.

io.modelcontextprotocol.client
├── McpClient.java         // 客户端工厂类
├── McpAsyncClient.java    // 异步客户端实现
├── McpSyncClient.java     // 同步客户端实现
└── McpClientFeatures.java // 客户端功能配置
1.
2.
3.
4.
5.

io.modelcontextprotocol.server
├── McpServer.java         // 服务端工厂类
├── McpAsyncServer.java    // 异步服务端实现
├── McpSyncServer.java     // 同步服务端实现
└── McpServerFeatures.java // 服务端功能配置
1.
2.
3.
4.
5.

io.modelcontextprotocol.client.transport
├── StdioClientTransport.java        // 标准输入输出传输
├── HttpClientSseClientTransport.java // HTTP SSE 客户端传输
├── FlowSseClient.java               // SSE 流式客户端
└── ServerParameters.java            // 服务器参数配置

io.modelcontextprotocol.server.transport
├── StdioServerTransport.java        // 标准输入输出传输
└── HttpServletSseServerTransport.java // HTTP SSE 服务端传输
1.
2.
3.
4.
5.
6.
7.
8.
9.

Client/Server -> Transport -> Session -> 协议版本协商 -> 能力协商
1.

请求/响应: 生成ID -> 序列化 -> 传输 -> 反序列化 -> 处理
通知: 序列化 -> 传输 -> 反序列化 -> 处理
1.
2.

发现 -> URI模板解析 -> 访问控制 -> 内容获取
1.

public static final String LATEST_PROTOCOL_VERSION = "2024-11-05";  // 最新协议版本
public static final String JSONRPC_VERSION = "2.0";                 // 使用 JSON-RPC 2.0
1.
2.

// 生命周期相关
METHOD_INITIALIZE = "initialize"                    // 初始化
METHOD_NOTIFICATION_INITIALIZED = "notifications/initialized"  // 初始化完成通知
METHOD_PING = "ping"                               // 心跳检测
1.
2.
3.
4.

// 工具相关
METHOD_TOOLS_LIST = "tools/list"                   // 列出可用工具
METHOD_TOOLS_CALL = "tools/call"                   // 调用工具
METHOD_NOTIFICATION_TOOLS_LIST_CHANGED = "notifications/tools/list_changed"  // 工具列表变更通知
1.
2.
3.
4.

// 资源相关
METHOD_RESOURCES_LIST = "resources/list"           // 列出资源
METHOD_RESOURCES_READ = "resources/read"           // 读取资源
METHOD_RESOURCES_TEMPLATES_LIST = "resources/templates/list"  // 列出资源模板
METHOD_RESOURCES_SUBSCRIBE = "resources/subscribe"    // 订阅资源
METHOD_RESOURCES_UNSUBSCRIBE = "resources/unsubscribe"  // 取消订阅
METHOD_NOTIFICATION_RESOURCES_LIST_CHANGED = "notifications/resources/list_changed"  // 资源列表变更通知
1.
2.
3.
4.
5.
6.
7.

// Prompt相关
METHOD_PROMPT_LIST = "prompts/list"                // 列出提示模板
METHOD_PROMPT_GET = "prompts/get"                  // 获取提示模板
METHOD_NOTIFICATION_PROMPTS_LIST_CHANGED = "notifications/prompts/list_changed"  // 提示模板列表变更通知
1.
2.
3.
4.

// 日志相关
METHOD_LOGGING_SET_LEVEL = "logging/setLevel"      // 设置日志级别
METHOD_NOTIFICATION_MESSAGE = "notifications/message"  // 日志消息通知
1.
2.
3.

public record ClientCapabilities(
    Experimental experimental,        // 实验性功能
    RootCapabilities roots,          // 根目录能力
    Sampling sampling                // 采样能力
)
1.
2.
3.
4.
5.

public record ServerCapabilities(
    Experimental experimental,       // 实验性功能
    LoggingCapabilities logging,     // 日志能力
    PromptCapabilities prompts,      // 提示模板能力
    ResourceCapabilities resources,  // 资源能力
    ToolCapabilities tools          // 工具能力
)
1.
2.
3.
4.
5.
6.
7.

sealed interface Content {
    TextContent      // 文本内容
    ImageContent     // 图片内容
    EmbeddedResource // 嵌入资源
}
1.
2.
3.
4.
5.

public record Root(
    String uri,   // 根目录URI (必须以 file:// 开头)
    String name   // 根目录名称(可选)
)
1.
2.
3.
4.

// 请求消息
public record JSONRPCRequest(
    String jsonrpc,    // JSON-RPC 版本
    String method,     // 方法名
    String id,        // 请求ID
    Object params     // 参数
)

// 响应消息
public record JSONRPCResponse(
    String jsonrpc,    // JSON-RPC 版本
    String id,        // 请求ID
    Object result,    // 响应结果
    JSONRPCError error // 错误信息
)

// 通知消息
public record JSONRPCNotification(
    String jsonrpc,    // JSON-RPC 版本
    String method,     // 方法名
    Object params     // 参数
)
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
20.
21.
22.