Struct ProxyHandler 

pub struct ProxyHandler { /* private fields */ }

A proxy handler that forwards requests to a client based on the server’s capabilities 使用 ArcSwap 实现后端热替换，支持断开时立即返回错误

Implementations

impl ProxyHandler

pub fn new_disconnected( mcp_id: String, tool_filter: ToolFilter, default_info: ServerInfo, ) -> Self

创建断开状态的 handler（用于初始化） 后续通过 swap_backend() 注入实际的后端连接

pub fn new(client: RunningService<RoleClient, ClientInfo>) -> Self

pub fn with_mcp_id( client: RunningService<RoleClient, ClientInfo>, mcp_id: String, ) -> Self

pub fn with_tool_filter( client: RunningService<RoleClient, ClientInfo>, mcp_id: String, tool_filter: ToolFilter, ) -> Self

创建带工具过滤器的 ProxyHandler（带初始后端连接）

pub fn swap_backend( &self, new_client: Option<RunningService<RoleClient, ClientInfo>>, )

原子性替换后端连接

• Some(client): 设置新的后端连接
• None: 标记后端断开

pub fn is_backend_available(&self) -> bool

检查后端是否可用（快速检查，不发送请求）

pub async fn is_mcp_server_ready(&self) -> bool

检查 mcp 服务是否正常（异步版本，会发送验证请求）

pub fn is_terminated(&self) -> bool

检查后端连接是否已关闭（同步版本，仅检查 transport 状态）

pub async fn is_terminated_async(&self) -> bool

异步检查后端连接是否已断开（会发送验证请求）

pub fn mcp_id(&self) -> &str

获取 MCP ID

Trait Implementations

impl Clone for ProxyHandler

fn clone(&self) -> ProxyHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyHandler

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl ServerHandler for ProxyHandler

fn get_info(&self) -> ServerInfo

async fn list_tools( &self, request: Option<PaginatedRequestParam>, context: RequestContext<RoleServer>, ) -> Result<ListToolsResult, ErrorData>

async fn call_tool( &self, request: CallToolRequestParam, context: RequestContext<RoleServer>, ) -> Result<CallToolResult, ErrorData>

async fn list_resources( &self, request: Option<PaginatedRequestParam>, context: RequestContext<RoleServer>, ) -> Result<ListResourcesResult, ErrorData>

async fn read_resource( &self, request: ReadResourceRequestParam, context: RequestContext<RoleServer>, ) -> Result<ReadResourceResult, ErrorData>

async fn list_resource_templates( &self, request: Option<PaginatedRequestParam>, context: RequestContext<RoleServer>, ) -> Result<ListResourceTemplatesResult, ErrorData>

async fn list_prompts( &self, request: Option<PaginatedRequestParam>, context: RequestContext<RoleServer>, ) -> Result<ListPromptsResult, ErrorData>

async fn get_prompt( &self, request: GetPromptRequestParam, context: RequestContext<RoleServer>, ) -> Result<GetPromptResult, ErrorData>

async fn complete( &self, request: CompleteRequestParam, context: RequestContext<RoleServer>, ) -> Result<CompleteResult, ErrorData>

async fn on_progress( &self, notification: ProgressNotificationParam, _context: NotificationContext<RoleServer>, )

async fn on_cancelled( &self, notification: CancelledNotificationParam, _context: NotificationContext<RoleServer>, )

fn ping( &self, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn initialize( &self, request: InitializeRequestParam, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<InitializeResult, ErrorData>> + Send

fn set_level( &self, request: SetLevelRequestParam, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn subscribe( &self, request: SubscribeRequestParam, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn unsubscribe( &self, request: UnsubscribeRequestParam, context: RequestContext<RoleServer>, ) -> impl Future<Output = Result<(), ErrorData>> + Send

fn on_initialized( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send

fn on_roots_list_changed( &self, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send

fn on_custom_notification( &self, notification: CustomClientNotification, context: NotificationContext<RoleServer>, ) -> impl Future<Output = ()> + Send