Struct Client

pub struct Client<T: Transport> { /* private fields */ }

An MCP client for connecting to MCP servers and invoking their tools.

The Client provides a high-level API for interacting with MCP servers, including initialization, tool discovery, and tool invocation.

Implementations

impl<T: Transport> Client<T>

pub fn builder(transport: T) -> ClientBuilder<T>

Creates a new client builder.

Arguments

• transport - The transport to use for communication with the server

Returns

A ClientBuilder for configuring and building the client

pub fn set_protocol_version(self, protocol_version: ProtocolVersion) -> Self

Sets the protocol version for the client.

Arguments

• protocol_version - The protocol version to use

Returns

The modified client instance

pub async fn open(&self) -> Result<()>

Opens the transport connection.

Returns

A Result indicating success or failure

pub async fn initialize(&self) -> Result<InitializeResponse>

Initializes the connection with the MCP server.

This sends the initialize request to the server, negotiates protocol version and capabilities, and establishes the session.

Returns

A Result containing the server’s initialization response if successful

pub async fn assert_initialized(&self) -> Result<(), Error>

Checks if the client has been initialized.

Returns

A Result indicating if the client is initialized

pub async fn request( &self, method: &str, params: Option<Value>, options: RequestOptions, ) -> Result<Value>

Sends a request to the server.

Arguments

• method - The method name
• params - Optional parameters for the request
• options - Request options (like timeout)

Returns

A Result containing the server’s response if successful

pub async fn list_tools( &self, cursor: Option<String>, request_options: Option<RequestOptions>, ) -> Result<ToolsListResponse>

Lists tools available on the server.

Arguments

• cursor - Optional pagination cursor
• request_options - Optional request options

Returns

A Result containing the list of tools if successful

pub async fn call_tool( &self, name: &str, arguements: Option<Value>, ) -> Result<CallToolResponse>

Calls a tool on the server.

Arguments

• name - The name of the tool to call
• arguments - Optional arguments for the tool

Returns

A Result containing the tool’s response if successful

pub async fn list_resources( &self, cursor: Option<String>, request_options: Option<RequestOptions>, ) -> Result<ResourcesListResponse>

Lists resources available on the server.

Arguments

• cursor - Optional pagination cursor
• request_options - Optional request options

Returns

A Result containing the list of resources if successful

pub async fn read_resource(&self, uri: Url) -> Result<Resource>

Reads a resource from the server.

Arguments

• uri - The URI of the resource to read

Returns

A Result containing the resource if successful

pub async fn subscribe_to_resource(&self, uri: Url) -> Result<()>

pub async fn unsubscribe_to_resource(&self, uri: Url) -> Result<()>

Trait Implementations

impl<T: Clone + Transport> Clone for Client<T>

fn clone(&self) -> Client<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.