Struct ProxyConfig 

pub struct ProxyConfig {
    pub proxy: ProxySettings,
    pub backends: Vec<BackendConfig>,
    pub auth: Option<AuthConfig>,
    pub performance: PerformanceConfig,
    pub security: SecurityConfig,
    pub observability: ObservabilityConfig,
}

Top-level proxy configuration, typically loaded from a TOML file.

Fields

proxy: ProxySettings

Core proxy settings (name, version, listen address).

backends: Vec<BackendConfig>

Backend MCP servers to proxy.

auth: Option<AuthConfig>

Inbound authentication configuration.

performance: PerformanceConfig

Performance tuning options.

security: SecurityConfig

Security policies.

observability: ObservabilityConfig

Logging, metrics, and tracing configuration.

Implementations

impl ProxyConfig

pub fn load(path: &Path) -> Result<Self>

Load and validate a config from a file path.

Examples found in repository

examples/library-mode.rs (line 37)

async fn main() -> Result<()> {
    tracing_subscriber::fmt()
        .with_env_filter("tower_mcp=info,mcp_proxy=info")
        .init();

    let cli = Cli::parse();

    // Load and resolve config
    let mut config = mcp_proxy::ProxyConfig::load(&cli.config)?;
    config.resolve_env_vars();

    let addr = format!("{}:{}", config.proxy.listen.host, config.proxy.listen.port);

    // Build the proxy
    let proxy = mcp_proxy::Proxy::from_config(config).await?;

    // Extract the router (includes MCP transport + admin API)
    let (proxy_router, _session_handle) = proxy.into_router();

    // Build custom application routes
    let app_routes = Router::new().route("/app/status", get(app_status));

    // Merge proxy router with custom routes
    let app = proxy_router.merge(app_routes);

    tracing::info!(listen = %addr, "Library mode example ready");

    let listener = tokio::net::TcpListener::bind(&addr).await?;
    axum::serve(listener, app).await?;

    Ok(())
}

pub fn parse(toml: &str) -> Result<Self>

Parse and validate a config from a TOML string.

Examples

use mcp_proxy::ProxyConfig;

let config = ProxyConfig::parse(r#"
    [proxy]
    name = "my-proxy"
    [proxy.listen]

    [[backends]]
    name = "echo"
    transport = "stdio"
    command = "echo"
"#).unwrap();

assert_eq!(config.proxy.name, "my-proxy");
assert_eq!(config.backends.len(), 1);

pub fn resolve_env_vars(&mut self)

Resolve environment variable references in config values. Replaces ${VAR_NAME} with the value of the environment variable.

Examples found in repository

examples/library-mode.rs (line 38)

async fn main() -> Result<()> {
    tracing_subscriber::fmt()
        .with_env_filter("tower_mcp=info,mcp_proxy=info")
        .init();

    let cli = Cli::parse();

    // Load and resolve config
    let mut config = mcp_proxy::ProxyConfig::load(&cli.config)?;
    config.resolve_env_vars();

    let addr = format!("{}:{}", config.proxy.listen.host, config.proxy.listen.port);

    // Build the proxy
    let proxy = mcp_proxy::Proxy::from_config(config).await?;

    // Extract the router (includes MCP transport + admin API)
    let (proxy_router, _session_handle) = proxy.into_router();

    // Build custom application routes
    let app_routes = Router::new().route("/app/status", get(app_status));

    // Merge proxy router with custom routes
    let app = proxy_router.merge(app_routes);

    tracing::info!(listen = %addr, "Library mode example ready");

    let listener = tokio::net::TcpListener::bind(&addr).await?;
    axum::serve(listener, app).await?;

    Ok(())
}

Trait Implementations

impl Debug for ProxyConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ProxyConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ProxyConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.