Struct McpServerHandle 

pub struct McpServerHandle {
    pub server: String,
    /* private fields */
}

P5-2: one connected server, wrapping the Arc<Mutex<McpClient>> every derived Tool/prompt-source shares — the single point that produces tools (McpTool), resource tools, prompt names, and the server’s folded-in instructions, so a caller (crates/cli’s attach_mcp) only has to connect once and ask this handle for everything else.

Fields

server: String

This server’s name (the mcp__<server>__… namespace prefix).

Implementations

impl McpServerHandle

pub fn new(server: impl Into<String>, client: McpClient) -> Self

Wrap an already-connected client under server’s name.

pub async fn instructions(&self) -> Option<String>

The server’s initialize-time instructions, if any.

pub async fn tools(&self) -> Result<Vec<McpTool>>

This server’s tools, namespaced mcp__<server>__<tool>.

pub fn resource_tools(&self) -> Vec<Box<dyn Tool>>

This server’s resource-access tools (resources_list/_read/ _subscribe), always offered regardless of whether the server actually advertised a resources capability — a server that doesn’t support resources simply errors clearly on the underlying resources/list call (the same “let the remote error surface” posture McpTool::execute already has for tools/call), rather than this client trying to pre-negotiate capabilities perfectly.

pub async fn prompts(&self) -> Result<Vec<(String, McpPromptSource)>>

This server’s prompts, namespaced mcp__<server>__<prompt> — see McpPromptSource’s doc comment for why namespacing (not a bare name) is the mechanism that keeps an untrusted/remote server from ever being able to collide with a trusted command name.

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

The shared client — for callers that need lower-level access (e.g. installing an elicitation handler, or OAuth token refresh wiring).

Trait Implementations

impl Clone for McpServerHandle

fn clone(&self) -> McpServerHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.