io.modelcontextprotocol.spec

Interface McpStreamableServerTransportProvider

All Superinterfaces:

McpServerTransportProviderBase

All Known Implementing Classes:

WebRxStreamableServerTransportProvider

public interface McpStreamableServerTransportProvider
extends McpServerTransportProviderBase

The core building block providing the server-side MCP transport for Streamable HTTP servers. Implement this interface to bridge between a particular server-side technology and the MCP server transport layer.

The lifecycle of the provider dictates that it be created first, upon application startup, and then passed into either McpServer.sync(McpStreamableServerTransportProvider) or McpServer.async(McpStreamableServerTransportProvider). As a result of the MCP server creation, the provider will be notified of a McpStreamableServerSession.Factory which will be used to handle a 1:1 communication between a newly connected client and the server using a session concept. The provider's responsibility is to create instances of McpStreamableServerTransport that the session will utilise during the session lifetime.

Finally, the McpStreamableServerTransports can be closed in bulk when close() or closeGracefully() are called as part of the normal application shutdown event. Individual McpStreamableServerTransports can also be closed on a per-session basis, where the McpServerSession.close() or McpServerSession.closeGracefully() closes the provided transport.

Author:

Dariusz Jędrzejczyk

Method Summary

Modifier and Type	Method and Description
default void	close() Immediately closes all the transports with connected clients and releases any associated resources.
reactor.core.publisher.Mono<Void>	closeGracefully() Gracefully closes all the transports with connected clients and releases any associated resources asynchronously.
reactor.core.publisher.Mono<Void>	notifyClients(String method, Object params) Sends a notification to all connected clients.
void	setSessionFactory(McpStreamableServerSession.Factory sessionFactory) Sets the session factory that will be used to create sessions for new clients.

Methods inherited from interface io.modelcontextprotocol.spec.McpServerTransportProviderBase

protocolVersions

Method Detail

setSessionFactory

void setSessionFactory(McpStreamableServerSession.Factory sessionFactory)

Sets the session factory that will be used to create sessions for new clients. An implementation of the MCP server MUST call this method before any MCP interactions take place.

Parameters:

sessionFactory - the session factory to be used for initiating client sessions

notifyClients

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

Sends a notification to all connected clients.

Specified by:

notifyClients in interface McpServerTransportProviderBase

Parameters:

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

params - parameters to be sent with the notification

Returns:

a Mono that completes when the notification has been broadcast

See Also:

McpSession#sendNotification(String, Map)

close

default void close()

Immediately closes all the transports with connected clients and releases any associated resources.

Specified by:

close in interface McpServerTransportProviderBase

closeGracefully

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

Gracefully closes all the transports with connected clients and releases any associated resources asynchronously.

Specified by:

closeGracefully in interface McpServerTransportProviderBase

Returns:

a Mono that completes when the connections have been closed.