public interface IMcpServer
| 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"(如实现该语义) 用于优雅关闭、刷新缓冲、释放资源等。
|
McpInitializeResult initialize(McpInitializeParams params, McpRequestContext ctx) throws McpRpcException
params - 初始化入参(协议版本、客户端能力、clientInfo)ctx - 请求上下文(会话、头、远端等)McpRpcException - 业务或协商失败时抛出,Handler 会包装成 JSON-RPC errorvoid notificationsInitialized(McpRequestContext ctx) throws McpRpcException
McpRpcExceptionMcpToolsListResult listTools(McpRequestContext ctx) throws McpRpcException
McpRpcExceptionMcpToolsCallResult callTool(McpToolsCallParams params, McpRequestContext ctx) throws McpRpcException
params - 工具名 + arguments(以及可选 _meta 已在模型中)McpRpcException - 工具不存在、校验失败或执行异常时抛出default void shutdown(McpRequestContext ctx) throws McpRpcException
McpRpcExceptiondefault void sessionClosed(McpRequestContext ctx)
Copyright © 2026. All rights reserved.