com.litongjava.mcp.server

Interface IMcpServer

public interface IMcpServer

核心服务端接口（无反射）：你的 McpHandler 在协议各阶段直接调用这些方法。 开发者实现本接口即可对接 MCP 协议： initialize -> 初始化握手 notificationsInitialized -> 客户端确认可接收事件 listTools -> 列出工具 callTool -> 调用工具 shutdown -> （可选）优雅关闭 sessionClosed -> （可选）会话结束清理

Method Summary

Modifier and Type	Method and Description
McpToolsCallResult	callTool(McpToolsCallParams params, McpRequestContext ctx) 对应: method = "tools/call"
McpInitializeResult	initialize(McpInitializeParams params, McpRequestContext ctx) 对应: method = "initialize"
McpToolsListResult	listTools(McpRequestContext ctx) 对应: method = "tools/list"
void	notificationsInitialized(McpRequestContext ctx) 对应: method = "notifications/initialized" 无入参；表示客户端已准备好接收事件（SSE）。 若需要，可在此处开始推送后台任务事件、预热资源等。
default void	sessionClosed(McpRequestContext ctx) （可选）HTTP DELETE /mcp 等触发的会话结束回调 可在这里清理 session 级别缓存、临时文件等。
default void	shutdown(McpRequestContext ctx) （可选）对应: method = "shutdown"（如实现该语义） 用于优雅关闭、刷新缓冲、释放资源等。

Method Detail

initialize

McpInitializeResult initialize(McpInitializeParams params,
                               McpRequestContext ctx)
                        throws McpRpcException

对应: method = "initialize"

Parameters:

params - 初始化入参（协议版本、客户端能力、clientInfo）

ctx - 请求上下文（会话、头、远端等）

Returns:

需要返回 serverInfo / capabilities / protocolVersion

Throws:

McpRpcException - 业务或协商失败时抛出，Handler 会包装成 JSON-RPC error

notificationsInitialized

void notificationsInitialized(McpRequestContext ctx)
                       throws McpRpcException

对应: method = "notifications/initialized" 无入参；表示客户端已准备好接收事件（SSE）。 若需要，可在此处开始推送后台任务事件、预热资源等。

Throws:

McpRpcException

listTools

McpToolsListResult listTools(McpRequestContext ctx)
                      throws McpRpcException

对应: method = "tools/list"

Returns:

工具清单（name/title/description/inputSchema...）

Throws:

McpRpcException

callTool

McpToolsCallResult callTool(McpToolsCallParams params,
                            McpRequestContext ctx)
                     throws McpRpcException

对应: method = "tools/call"

Parameters:

params - 工具名 + arguments（以及可选 _meta 已在模型中）

Returns:

工具结果（content[], isError, _meta）

Throws:

McpRpcException - 工具不存在、校验失败或执行异常时抛出

shutdown

default void shutdown(McpRequestContext ctx)
               throws McpRpcException

（可选）对应: method = "shutdown"（如实现该语义） 用于优雅关闭、刷新缓冲、释放资源等。

Throws:

McpRpcException

sessionClosed

default void sessionClosed(McpRequestContext ctx)

（可选）HTTP DELETE /mcp 等触发的会话结束回调 可在这里清理 session 级别缓存、临时文件等。