Struct Proxy 

pub struct Proxy { /* private fields */ }

A fully constructed MCP proxy ready to serve or embed.

Implementations

impl Proxy

pub async fn from_config(config: ProxyConfig) -> Result<Self>

Build a proxy from a ProxyConfig.

Connects to all backends, builds the middleware stack, and prepares the axum router. Call serve() to run standalone or into_router() to embed in an existing app.

pub fn session_handle(&self) -> &SessionHandle

Get a reference to the session handle for monitoring active sessions.

pub fn mcp_proxy(&self) -> &McpProxy

Get a reference to the underlying McpProxy for dynamic operations.

Use this to add backends dynamically via McpProxy::add_backend().

pub fn enable_hot_reload(&self, config_path: PathBuf)

Enable hot reload by watching the given config file path.

New backends added to the config file will be connected dynamically without restarting the proxy.

pub fn into_router(self) -> (Router, SessionHandle)

Consume the proxy and return the axum Router and SessionHandle.

Use this to embed the proxy in an existing axum application:

let (proxy_router, session_handle) = proxy.into_router();

let app = Router::new()
    .nest("/mcp", proxy_router)
    .route("/health", get(|| async { "ok" }));

pub async fn serve(self) -> Result<()>

Serve the proxy on the configured listen address.

Blocks until a shutdown signal (SIGTERM/SIGINT) is received, then drains connections for the configured timeout period.