Struct RemoteMcpServerConfig 

pub struct RemoteMcpServerConfig {
    pub public_url: Url,
    pub authorization_server: Url,
    pub citation_url_prefix: Option<Url>,
    pub allowed_origins: Vec<String>,
    pub max_results: usize,
    pub max_scan_files: usize,
    pub max_scan_bytes: usize,
    pub max_request_body_bytes: usize,
    pub session_ttl: Duration,
    /* private fields */
}

Runtime configuration for the remote MCP transport.

The proxy bearer token is intentionally private and is omitted from the Debug implementation. It must never be copied into a URL or persisted.

Fields

public_url: Url

Canonical external HTTPS URL, normally the legacy /sse/ endpoint.

authorization_server: Url

External authorization server URL advertised in protected-resource metadata.

citation_url_prefix: Option<Url>

Optional URL prefix for escaped file citations.

allowed_origins: Vec<String>

Separate allowlist for supplied MCP Origin headers.

max_results: usize

Maximum number of search results.

max_scan_files: usize

Maximum files inspected by search.

max_scan_bytes: usize

Maximum UTF-8 content bytes inspected by search.

max_request_body_bytes: usize

Maximum legacy MCP request body size.

session_ttl: Duration

Legacy SSE session inactivity lifetime.

Implementations

impl RemoteMcpServerConfig

pub fn new( public_url: impl AsRef<str>, authorization_server: impl AsRef<str>, proxy_bearer_token: impl Into<String>, ) -> WebmcpResult<Self>

Create a validated remote MCP configuration with the default bounds.

pub fn validate(&self) -> WebmcpResult<()>

Validate URL, authentication, and resource bounds.

pub fn with_citation_url_prefix(self, prefix: Option<Url>) -> WebmcpResult<Self>

Set the citation prefix after parsing it as a URL.

pub fn with_allowed_origins(self, origins: Vec<String>) -> WebmcpResult<Self>

Set the separate MCP Origin allowlist.

pub fn with_limits( self, max_results: usize, max_scan_files: usize, max_scan_bytes: usize, max_request_body_bytes: usize, session_ttl: Duration, ) -> WebmcpResult<Self>

Set the search and legacy transport bounds.

Trait Implementations

impl Clone for RemoteMcpServerConfig

fn clone(&self) -> RemoteMcpServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteMcpServerConfig

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

Formats the value using the given formatter.