io.modelcontextprotocol.spec

Interface McpSession

All Known Subinterfaces:

McpLoggableSession

All Known Implementing Classes:

McpClientSession, McpServerSession, McpStreamableServerSession, McpStreamableServerSession.McpStreamableServerSessionStream, MissingMcpTransportSession

public interface McpSession

Represents a Model Context Protocol (MCP) session that handles communication between clients and the server. This interface provides methods for sending requests and notifications, as well as managing the session lifecycle.

The session operates asynchronously using Project Reactor's Mono type for non-blocking operations. It supports both request-response patterns and one-way notifications.

Author:

Christian Tzolov, Dariusz Jędrzejczyk

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.
default reactor.core.publisher.Mono<Void>	sendNotification(String method) Sends a notification to the model client or server without parameters.
reactor.core.publisher.Mono<Void>	sendNotification(String method, 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.

Method Detail

sendRequest

<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.

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.

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

default reactor.core.publisher.Mono<Void> sendNotification(String method)

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

This method implements the notification pattern where no response is expected from the counterparty. It's useful for fire-and-forget scenarios.

Parameters:

method - the name of the notification method to be called on the server

Returns:

a Mono that completes when the notification has been sent

sendNotification

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

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

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

Parameters:

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

params - parameters to be sent with the notification

Returns:

a Mono that completes when the notification has been sent

closeGracefully

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

Closes the session and releases any associated resources asynchronously.

Returns:

a Mono that completes when the session has been closed.

close

void close()

Closes the session and releases any associated resources.