mcp-stdio-proxy 0.2.9

MCP (Model Context Protocol) proxy server and CLI tool for protocol conversion and remote service access
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

//! Proxy module - re-exports handler types from proxy libraries
//!
//! This module provides a unified interface for proxy handlers by re-exporting
//! types from mcp-sse-proxy, mcp-streamable-proxy, and mcp-common libraries.

// Re-export SseHandler as ProxyHandler for backward compatibility
// SseHandler is used because it's based on rmcp 0.10 which supports both
// SSE server mode and CLI stdio mode used in the main project
pub use mcp_sse_proxy::SseHandler as ProxyHandler;

// Re-export SseServerHandler (unified handler for SSE server mode)
pub use mcp_sse_proxy::SseServerHandler;

// Re-export StreamProxyHandler with an alias to distinguish from SSE ProxyHandler
// Both mcp-sse-proxy and mcp-streamable-proxy export ProxyHandler, so we use an alias
pub use mcp_streamable_proxy::ProxyHandler as StreamProxyHandler;

// Re-export ToolFilter from mcp-common
pub use mcp_common::ToolFilter;

// Re-export client connection types for high-level API (each from its own library)
pub use mcp_sse_proxy::{McpClientConfig, SseClientConnection};
pub use mcp_streamable_proxy::StreamClientConnection;

// Re-export Builder APIs for server creation
pub use mcp_sse_proxy::server_builder::{BackendConfig as SseBackendConfig, SseServerBuilder};
pub use mcp_streamable_proxy::server_builder::{
    BackendConfig as StreamBackendConfig, StreamServerBuilder,
};

/// Unified handler enum that can hold either SSE or Stream handler
///
/// This allows ProxyHandlerManager to store handlers of either type
/// while providing a common interface for status checks.
#[derive(Clone, Debug)]
pub enum McpHandler {
    /// SSE protocol handler (from mcp-sse-proxy)
    /// Holds SseServerHandler which unifies SseHandler and BackendSessionHandler
    Sse(Box<SseServerHandler>),
    /// Streamable HTTP protocol handler (from mcp-streamable-proxy)
    Stream(Box<StreamProxyHandler>),
}

impl McpHandler {
    /// Check if the underlying MCP server is ready
    pub async fn is_mcp_server_ready(&self) -> bool {
        match self {
            McpHandler::Sse(h) => h.is_mcp_server_ready().await,
            McpHandler::Stream(h) => h.is_mcp_server_ready().await,
        }
    }

    /// Check if the backend connection is terminated
    pub async fn is_terminated_async(&self) -> bool {
        match self {
            McpHandler::Sse(h) => h.is_terminated_async().await,
            McpHandler::Stream(h) => h.is_terminated_async().await,
        }
    }
}

impl From<ProxyHandler> for McpHandler {
    fn from(handler: ProxyHandler) -> Self {
        McpHandler::Sse(Box::new(SseServerHandler::Sse(handler)))
    }
}

impl From<SseServerHandler> for McpHandler {
    fn from(handler: SseServerHandler) -> Self {
        McpHandler::Sse(Box::new(handler))
    }
}

impl From<StreamProxyHandler> for McpHandler {
    fn from(handler: StreamProxyHandler) -> Self {
        McpHandler::Stream(Box::new(handler))
    }
}