Struct Protocol

pub struct Protocol { /* private fields */ }

The core protocol handler for MCP.

The Protocol struct manages the lifecycle of JSON-RPC requests and responses, dispatches incoming requests to the appropriate handlers, and manages pending requests and their responses.

Implementations

impl Protocol

pub fn builder() -> ProtocolBuilder

Creates a new protocol builder.

Returns

A ProtocolBuilder for configuring the protocol

pub async fn handle_request(&self, request: JsonRpcRequest) -> JsonRpcResponse

Handles an incoming JSON-RPC request.

This method dispatches the request to the appropriate handler based on the request method, and returns the handler’s response.

Arguments

• request - The incoming JSON-RPC request

Returns

A JsonRpcResponse containing the handler’s response or an error

pub async fn handle_notification(&self, request: JsonRpcNotification)

Handles an incoming JSON-RPC notification.

This method dispatches the notification to the appropriate handler based on the notification method.

Arguments

• request - The incoming JSON-RPC notification

pub fn new_message_id(&self) -> u64

Generates a new unique message ID for requests.

Returns

A unique message ID

pub async fn create_request(&self) -> (u64, Receiver<JsonRpcResponse>)

Creates a new request ID and channel for receiving the response.

Returns

A tuple containing the request ID and a receiver for the response

pub async fn handle_response(&self, response: JsonRpcResponse)

Handles an incoming JSON-RPC response.

This method delivers the response to the appropriate waiting request, if any.

Arguments

• response - The incoming JSON-RPC response

pub async fn cancel_response(&self, id: u64)

Cancels a pending request and sends an error response.

Arguments

• id - The ID of the request to cancel

Trait Implementations

impl Clone for Protocol

fn clone(&self) -> Protocol

Returns a duplicate of the value.

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

Performs copy-assignment from source.