io.modelcontextprotocol.spec

Class StatelessMcpSession

java.lang.Object

io.modelcontextprotocol.spec.StatelessMcpSession

All Implemented Interfaces:

McpSession

public class StatelessMcpSession
extends Object
implements McpSession

Constructor Summary

Constructors

Constructor and Description
StatelessMcpSession(McpTransport transport)

Method Summary

Modifier and Type	Method and Description
void	close() Closes the session and releases any associated resources.
reactor.core.publisher.Mono<Void>	closeGracefully() Closes the session and releases any associated resources asynchronously.
String	getId() Retrieve the session id.
reactor.core.publisher.Mono<Void>	handle(McpSchema.JSONRPCMessage message) Called by the McpServerTransportProvider once the session is determined.
reactor.core.publisher.Mono<Void>	sendNotification(String method, Map<String,Object> params) Sends a notification to the model client or server with parameters.
<T> reactor.core.publisher.Mono<T>	sendRequest(String method, Object requestParams, com.fasterxml.jackson.core.type.TypeReference<T> typeRef) Sends a request to the model counterparty and expects a response of type T.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.modelcontextprotocol.spec.McpSession

sendNotification

Constructor Detail

StatelessMcpSession

public StatelessMcpSession(McpTransport transport)

Method Detail

getId

public String getId()

Description copied from interface: McpSession

Retrieve the session id.

Specified by:

getId in interface McpSession

Returns:

session id

handle

public reactor.core.publisher.Mono<Void> handle(McpSchema.JSONRPCMessage message)

Description copied from interface: McpSession

Called by the McpServerTransportProvider once the session is determined. The purpose of this method is to dispatch the message to an appropriate handler as specified by the MCP server implementation (McpAsyncServer or McpSyncServer) via McpServerSession.Factory that the server creates.

Specified by:

handle in interface McpSession

Parameters:

message - the incoming JSON-RPC message

Returns:

a Mono that completes when the message is processed

sendRequest

public <T> reactor.core.publisher.Mono<T> sendRequest(String method,
                                                      Object requestParams,
                                                      com.fasterxml.jackson.core.type.TypeReference<T> typeRef)

Description copied from interface: McpSession

Sends a request to the model counterparty and expects a response of type T.

This method handles the request-response pattern where a response is expected from the client or server. The response type is determined by the provided TypeReference.

Specified by:

sendRequest in interface McpSession

Type Parameters:

T - the type of the expected response

Parameters:

method - the name of the method to be called on the counterparty

requestParams - the parameters to be sent with the request

typeRef - the TypeReference describing the expected response type

Returns:

a Mono that will emit the response when received

sendNotification

public reactor.core.publisher.Mono<Void> sendNotification(String method,
                                                          Map<String,Object> params)

Description copied from interface: McpSession

Sends a notification to the model client or server with parameters.

Similar to McpSession.sendNotification(String) but allows sending additional parameters with the notification.

Specified by:

sendNotification in interface McpSession

Parameters:

method - the name of the notification method to be sent to the counterparty

params - a map of parameters to be sent with the notification

Returns:

a Mono that completes when the notification has been sent

closeGracefully

public reactor.core.publisher.Mono<Void> closeGracefully()

Description copied from interface: McpSession

Closes the session and releases any associated resources asynchronously.

Specified by:

closeGracefully in interface McpSession

Returns:

a Mono that completes when the session has been closed.

close

public void close()

Description copied from interface: McpSession

Closes the session and releases any associated resources.

Specified by:

close in interface McpSession