Package org.apache.juneau.rest.client.mcp

Interface McpServerRequestHandler

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface McpServerRequestHandler

Callback invoked by McpDuplexDispatcher to handle a single server-initiated JSON-RPC request delivered over an MCP client's duplex event-stream channel (for example sampling/createMessage; illustrative only, as sampling is deprecated per SEP-2577).

Since:

10.0.0

Method Summary

Modifier and Type	Method	Description
Object	handle(JsonRpcRequest request, BeanStore ctx)	Handles a single server-initiated request.

Method Details

handle

Object handle(JsonRpcRequest request,
 BeanStore ctx)
       throws Exception

Handles a single server-initiated request.

Parameters:

request - The inbound request, with its params left as the generic, revision-neutral wire representation. Never null.

ctx - The request-scoped bean store. Never null.

Returns:

The result to return to the server, marshaled as the result of the JSON-RPC response McpDuplexDispatcher posts back. Can be null.

Throws:

Exception - If handling fails. An McpException thrown here propagates to the caller as-is; any other exception is wrapped by McpDuplexDispatcher.dispatch(JsonRpcRequest, BeanStore) as a -32603 internal-error McpException.