Skip to main content

ClientSession

Struct ClientSession 

Source
pub struct ClientSession { /* private fields */ }
Expand description

Client session that manages connection lifecycle and notifications

Implementations§

Source§

impl ClientSession

Source

pub fn new(client: McpClient) -> Self

Create a new client session

Source

pub fn with_config(client: McpClient, config: SessionConfig) -> Self

Create a new client session with custom configuration

Source

pub async fn state(&self) -> SessionState

Get the current session state

Source

pub fn subscribe_state_changes(&self) -> Receiver<SessionState>

Subscribe to state changes

Source

pub async fn is_connected(&self) -> bool

Check if the session is connected

Source

pub async fn uptime(&self) -> Option<Duration>

Get connection uptime

Source

pub async fn add_notification_handler<H>(&self, handler: H)
where H: NotificationHandler + 'static,

Add a notification handler

Source

pub async fn connect<T>(&self, transport: T) -> McpResult<ConnectResult>
where T: Transport + 'static,

Connect to the server with the provided transport

Source

pub async fn disconnect(&self) -> McpResult<()>

Disconnect from the server

Source

pub async fn reconnect<T>( &self, transport_factory: impl Fn() -> T + Send + Sync + 'static, ) -> McpResult<ConnectResult>
where T: Transport + 'static,

Reconnect to the server with smart retry logic

Source

pub fn client(&self) -> Arc<Mutex<McpClient>> ⓘ

Get the underlying client (for direct operations)

Source

pub fn config(&self) -> &SessionConfig

Get session configuration

Source

pub async fn list_tools( &self, cursor: Option<String>, ) -> McpResult<ListToolsResult>

List available tools from the server

Source

pub async fn call_tool( &self, params: CallToolParams, ) -> McpResult<CallToolResult>

Call a tool on the server

Source

pub async fn list_resources( &self, cursor: Option<String>, ) -> McpResult<ListResourcesResult>

List available resources from the server

Source

pub async fn read_resource( &self, params: ReadResourceParams, ) -> McpResult<ReadResourceResult>

Read a resource from the server

Source

pub async fn list_prompts( &self, cursor: Option<String>, ) -> McpResult<ListPromptsResult>

List available prompts from the server

Source

pub async fn get_prompt( &self, params: GetPromptParams, ) -> McpResult<GetPromptResult>

Get a prompt from the server

Source§

impl ClientSession

Source

pub async fn stats(&self) -> SessionStats

Get session statistics

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> FutureExt for T

§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
§

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more
§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> IntoRequest<T> for T

§

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request
§

impl<L> LayerExt<L> for L

§

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in [Layered].
§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more