Enum ServerMessage 

pub enum ServerMessage {
    Request(ServerJsonrpcRequest),
    Notification(ServerJsonrpcNotification),
    Response(ServerJsonrpcResponse),
    Error(JsonrpcError),
}

“Similar to JsonrpcMessage, but with the variants restricted to client-side messages.” ServerMessage represents a message sent by an MCP Server and received by an MCP Client.

Variants

Request(ServerJsonrpcRequest)

Notification(ServerJsonrpcNotification)

Response(ServerJsonrpcResponse)

Error(JsonrpcError)

Implementations

impl ServerMessage

pub fn as_response(self) -> Result<ServerJsonrpcResponse, RpcError>

Converts the current message into a ServerJsonrpcResponse if it’s of the correct type.

This function checks if the current message is of type Response. If so, it returns the ServerJsonrpcResponse wrapped in a Result::Ok. If the message is not a Response, it returns an error with a descriptive message indicating the mismatch in expected message types.

Returns

• Ok(ServerJsonrpcResponse) if the message is a valid Response.
• Err(RpcError) if the message type is invalid

pub fn as_request(self) -> Result<ServerJsonrpcRequest, RpcError>

Converts the current message into a ServerJsonrpcRequest if it’s of the correct type.

This function checks if the current message is of type Request. If so, it returns the ServerJsonrpcRequest wrapped in a Result::Ok. If the message is not a Request, it returns an error with a descriptive message indicating the mismatch in expected message types.

Returns

• Ok(ServerJsonrpcRequest) if the message is a valid Request.
• Err(RpcError) if the message type is invalid

pub fn as_notification(self) -> Result<ServerJsonrpcNotification, RpcError>

Converts the current message into a ServerJsonrpcNotification if it’s of the correct type.

This function checks if the current message is of type Notification. If so, it returns the ServerJsonrpcNotification wrapped in a Result::Ok. If the message is not a Notification, it returns an error with a descriptive message indicating the mismatch in expected message types.

Returns

• Ok(ServerJsonrpcNotification) if the message is a valid Notification.
• Err(RpcError) if the message type is invalid

pub fn as_error(self) -> Result<JsonrpcError, RpcError>

Converts the current message into a JsonrpcError if it’s of the correct type.

This function checks if the current message is of type Error. If so, it returns the JsonrpcError wrapped in a Result::Ok. If the message is not a Error, it returns an error with a descriptive message indicating the mismatch in expected message types.

Returns

• Ok(JsonrpcError) if the message is a valid Error.
• Err(RpcError) if the message type is invalid

Trait Implementations

impl Clone for ServerMessage

fn clone(&self) -> ServerMessage

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServerMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServerMessage

fn deserialize<__D>( __deserializer: __D, ) -> Result<ServerMessage, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ServerMessage

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<ServerJsonrpcNotification> for ServerMessage

fn from(value: ServerJsonrpcNotification) -> ServerMessage

Converts to this type from the input type.

impl From<ServerJsonrpcRequest> for ServerMessage

fn from(value: ServerJsonrpcRequest) -> ServerMessage

Converts to this type from the input type.

impl From<ServerJsonrpcResponse> for ServerMessage

fn from(value: ServerJsonrpcResponse) -> ServerMessage

Converts to this type from the input type.

impl From<ServerMessage> for ServerMessages

fn from(value: ServerMessage) -> ServerMessages

Converts to this type from the input type.

impl FromMessage<CallToolResult> for ServerMessage

fn from_message( message: CallToolResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<CancelledNotification> for ServerMessage

fn from_message( message: CancelledNotification, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<CompleteResult> for ServerMessage

fn from_message( message: CompleteResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<CreateMessageRequest> for ServerMessage

fn from_message( message: CreateMessageRequest, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ElicitRequest> for ServerMessage

fn from_message( message: ElicitRequest, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<GetPromptResult> for ServerMessage

fn from_message( message: GetPromptResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<InitializeResult> for ServerMessage

fn from_message( message: InitializeResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ListPromptsResult> for ServerMessage

fn from_message( message: ListPromptsResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ListResourceTemplatesResult> for ServerMessage

fn from_message( message: ListResourceTemplatesResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ListResourcesResult> for ServerMessage

fn from_message( message: ListResourcesResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ListRootsRequest> for ServerMessage

fn from_message( message: ListRootsRequest, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ListToolsResult> for ServerMessage

fn from_message( message: ListToolsResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<LoggingMessageNotification> for ServerMessage

fn from_message( message: LoggingMessageNotification, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<MessageFromServer> for ServerMessage

fn from_message( message: MessageFromServer, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<PingRequest> for ServerMessage

fn from_message( message: PingRequest, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ProgressNotification> for ServerMessage

fn from_message( message: ProgressNotification, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<PromptListChangedNotification> for ServerMessage

fn from_message( message: PromptListChangedNotification, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ReadResourceResult> for ServerMessage

fn from_message( message: ReadResourceResult, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ResourceListChangedNotification> for ServerMessage

fn from_message( message: ResourceListChangedNotification, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ResourceUpdatedNotification> for ServerMessage

fn from_message( message: ResourceUpdatedNotification, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<Result> for ServerMessage

fn from_message( message: Result, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromMessage<ToolListChangedNotification> for ServerMessage

fn from_message( message: ToolListChangedNotification, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl FromStr for ServerMessage

type Err = RpcError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<ServerMessage, <ServerMessage as FromStr>::Err>

Parses a string s to return a value of this type.

impl McpDispatch<ClientMessages, ServerMessages, ClientMessage, ServerMessage> for MessageDispatcher<ClientMessage>

fn send_message<'life0, 'async_trait>( &'life0 self, messages: ServerMessages, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ClientMessages>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, MessageDispatcher<ClientMessage>: 'async_trait,

Sends a message from the server to the client and awaits a response if applicable.

Serializes the ServerMessages to JSON, writes it to the transport, and waits for a ClientMessages response if the message is a request. Notifications and responses return Ok(None).

Arguments

• messages - The client message to send, coulld be a single message or batch.

Returns

A TransportResult containing Some(ClientMessages) for requests with a response, or None for notifications/responses, or an error if the operation fails.

Errors

Returns a TransportError if serialization, writing, or timeout occurs.

fn write_str<'life0, 'life1, 'async_trait>( &'life0 self, payload: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, MessageDispatcher<ClientMessage>: 'async_trait,

Writes a string payload to the underlying asynchronous writable stream, appending a newline character and flushing the stream afterward.

fn send<'life0, 'async_trait>( &'life0 self, message: ServerMessage, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ClientMessage>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, MessageDispatcher<ClientMessage>: 'async_trait,

fn send_batch<'life0, 'async_trait>( &'life0 self, message: Vec<ServerMessage>, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<ClientMessage>>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, MessageDispatcher<ClientMessage>: 'async_trait,

impl McpDispatch<ClientMessages, ServerMessages, ClientMessage, ServerMessage> for SseTransport<ClientMessage>

fn send_message<'life0, 'async_trait>( &'life0 self, message: ServerMessages, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ClientMessages>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

Sends a raw message represented by type S and optionally includes a request_id. The request_id is used when sending a message in response to an MCP request. It should match the request_id of the original request.

fn send<'life0, 'async_trait>( &'life0 self, message: ServerMessage, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ClientMessage>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

fn send_batch<'life0, 'async_trait>( &'life0 self, message: Vec<ServerMessage>, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<ClientMessage>>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

fn write_str<'life0, 'life1, 'async_trait>( &'life0 self, payload: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

Writes a string payload to the underlying asynchronous writable stream, appending a newline character and flushing the stream afterward.

impl McpDispatch<ClientMessages, ServerMessages, ClientMessage, ServerMessage> for StdioTransport<ClientMessage>

fn send_message<'life0, 'async_trait>( &'life0 self, message: ServerMessages, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ClientMessages>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, StdioTransport<ClientMessage>: 'async_trait,

Sends a raw message represented by type S and optionally includes a request_id. The request_id is used when sending a message in response to an MCP request. It should match the request_id of the original request.

fn send<'life0, 'async_trait>( &'life0 self, message: ServerMessage, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ClientMessage>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, StdioTransport<ClientMessage>: 'async_trait,

fn send_batch<'life0, 'async_trait>( &'life0 self, message: Vec<ServerMessage>, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<ClientMessage>>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, StdioTransport<ClientMessage>: 'async_trait,

fn write_str<'life0, 'life1, 'async_trait>( &'life0 self, payload: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, StdioTransport<ClientMessage>: 'async_trait,

Writes a string payload to the underlying asynchronous writable stream, appending a newline character and flushing the stream afterward.

impl McpDispatch<ServerMessages, ClientMessages, ServerMessage, ClientMessage> for MessageDispatcher<ServerMessage>

fn send_message<'life0, 'async_trait>( &'life0 self, messages: ClientMessages, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ServerMessages>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, MessageDispatcher<ServerMessage>: 'async_trait,

Sends a message from the client to the server and awaits a response if applicable.

Serializes the ClientMessages to JSON, writes it to the transport, and waits for a ServerMessages response if the message is a request. Notifications and responses return Ok(None).

Arguments

• messages - The client message to send, coulld be a single message or batch.

Returns

A TransportResult containing Some(ServerMessages) for requests with a response, or None for notifications/responses, or an error if the operation fails.

Errors

Returns a TransportError if serialization, writing, or timeout occurs.

fn write_str<'life0, 'life1, 'async_trait>( &'life0 self, payload: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, MessageDispatcher<ServerMessage>: 'async_trait,

Writes a string payload to the underlying asynchronous writable stream, appending a newline character and flushing the stream afterward.

fn send<'life0, 'async_trait>( &'life0 self, message: ClientMessage, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<ServerMessage>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, MessageDispatcher<ServerMessage>: 'async_trait,

fn send_batch<'life0, 'async_trait>( &'life0 self, message: Vec<ClientMessage>, request_timeout: Option<Duration>, ) -> Pin<Box<dyn Future<Output = Result<Option<Vec<ServerMessage>>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, MessageDispatcher<ServerMessage>: 'async_trait,

impl McpMessage for ServerMessage

fn message_type(&self) -> MessageTypes

Determines the type of the message and returns the corresponding MessageTypes variant.

fn is_response(&self) -> bool

fn is_request(&self) -> bool

fn is_notification(&self) -> bool

fn is_error(&self) -> bool

impl RpcMessage for ServerMessage

fn request_id(&self) -> Option<&RequestId>

fn jsonrpc(&self) -> &str

impl Serialize for ServerMessage

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToMessage<ServerMessage> for CallToolResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for CancelledNotification

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for CompleteResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for CreateMessageRequest

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ElicitRequest

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for GetPromptResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for InitializeResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ListPromptsResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ListResourceTemplatesResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ListResourcesResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ListRootsRequest

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ListToolsResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for LoggingMessageNotification

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for PingRequest

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ProgressNotification

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for PromptListChangedNotification

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ReadResourceResult

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ResourceListChangedNotification

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ResourceUpdatedNotification

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for Result

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl ToMessage<ServerMessage> for ToolListChangedNotification

fn to_message( self, request_id: Option<RequestId>, ) -> Result<ServerMessage, RpcError>

impl Transport<ClientMessages, MessageFromServer, ClientMessage, ServerMessages, ServerMessage> for SseTransport<ClientMessage>

fn start<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<ReceiverStream<ClientMessages>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, MessageDispatcher<ClientMessage>: McpDispatch<ClientMessages, ServerMessages, ClientMessage, ServerMessage>, SseTransport<ClientMessage>: 'async_trait,

Starts the transport, initializing streams and message dispatcher

Sets up the MCP stream and dispatcher using the provided duplex streams.

Returns

• TransportResult<(Pin<Box<dyn Stream<Item = R> + Send>>, MessageDispatcher<R>, IoStream)>
  • The message stream, dispatcher, and error stream

Errors

• Returns TransportError if streams are already taken or not initialized

fn is_shut_down<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = bool> + Send + 'async_trait>>

where 'life0: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

Checks if the transport has been shut down

Returns

• bool - True if the transport is shut down, false otherwise

fn shut_down<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<(), TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

Shuts down the transport, terminating tasks and signaling closure

Cancels any running tasks and clears the cancellation source.

Returns

• TransportResult<()> - Ok if shutdown is successful, Err if cancellation fails

fn message_sender( &self, ) -> Arc<RwLock<Option<MessageDispatcher<ClientMessage>>>>

fn error_stream(&self) -> &RwLock<Option<IoStream>>

fn consume_string_payload<'life0, 'life1, 'async_trait>( &'life0 self, payload: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<(), TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

fn keep_alive<'life0, 'async_trait>( &'life0 self, interval: Duration, disconnect_tx: Sender<()>, ) -> Pin<Box<dyn Future<Output = Result<JoinHandle<()>, TransportError>> + Send + 'async_trait>>

where 'life0: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

fn pending_request_tx<'life0, 'life1, 'async_trait>( &'life0 self, request_id: &'life1 RequestId, ) -> Pin<Box<dyn Future<Output = Option<Sender<ClientMessage>>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, SseTransport<ClientMessage>: 'async_trait,

impl TransportDispatcher<ClientMessages, MessageFromServer, ClientMessage, ServerMessages, ServerMessage> for SseTransport<ClientMessage>

impl TransportDispatcher<ClientMessages, MessageFromServer, ClientMessage, ServerMessages, ServerMessage> for StdioTransport<ClientMessage>