Struct ServerManager 

pub struct ServerManager { /* private fields */ }

Manages all MCP server connections with lazy connection, idle timeout, and health checks.

Implementations

impl ServerManager

pub fn new(global_idle_timeout_minutes: u64) -> Self

pub fn register(&mut self, name: &str, entry: ServerEntry, config_hash: u64)

Register or update a server definition (from config). Does not connect. If the server already exists, its entry is replaced and the old connection is dropped so that next use reconnects with the new config.

pub async fn ensure_connected(&mut self, name: &str) -> bool

Ensure a server is connected (lazy connect). Returns true if connected/available.

pub fn get_client(&self, name: &str) -> Option<Arc<Mutex<McpClient>>>

Get a connected client for a server (must call ensure_connected first).

pub fn status(&self, name: &str) -> Option<ConnectionStatus>

Get the connection status for a server.

pub fn mark_failed(&mut self, name: &str)

Mark a connection as failed after a tool call error.

pub fn touch(&mut self, name: &str)

Touch a server (update last_used timestamp, e.g. after successful tool call).

pub async fn disconnect(&mut self, name: &str)

Disconnect a server (idle shutdown).

pub async fn close_all(&mut self)

Close all connections (on session shutdown).

pub fn idle_timeout(&self, name: &str) -> Duration

Get the idle timeout for a server (per-server override or global default).

pub async fn sweep_idle(&mut self)

Check for idle servers and disconnect them.

pub fn server_names(&self) -> Vec<String>

Get a list of all registered server names.

pub fn remove(&mut self, name: &str)

Synchronously remove a server entry, dropping any existing connection. The client Arc is dropped; in-flight calls holding a clone of the Arc can still complete.

pub fn should_connect_eagerly(&self, name: &str) -> bool

Check if a server should be connected eagerly at startup.

pub fn config_hash(&self, name: &str) -> Option<u64>

Get the config hash for a server.