Struct McpServerConfig 

pub struct McpServerConfig {
    pub name: String,
    pub transport: McpTransport,
    pub url: Option<String>,
    pub command: String,
    pub args: Vec<String>,
    pub env: HashMap<String, String>,
    pub headers: HashMap<String, String>,
    pub tool_timeout_secs: Option<u64>,
    pub max_response_bytes: Option<u64>,
    pub pinned_resources: Vec<String>,
    pub tls_ca_cert_path: Option<String>,
}

Configuration for a single external MCP server.

Fields

name: String

Display name used as a tool prefix (<server>__<tool>). Filled in from the supplied map_key when the entry is created via create_map_key("mcp.servers", "<name>"); #[serde(default)] lets the macro default-construct from {} before the name gets injected.

transport: McpTransport

Transport type (default: stdio).

url: Option<String>

URL for HTTP/SSE transports.

command: String

Executable to spawn for stdio transport.

args: Vec<String>

Command arguments for stdio transport.

env: HashMap<String, String>

Optional environment variables for stdio transport.

headers: HashMap<String, String>

Optional HTTP headers for HTTP/SSE transports. Treated as secret: the values commonly carry Bearer tokens for the upstream MCP server.

tool_timeout_secs: Option<u64>

Optional per-call timeout in seconds (hard capped in validation).

max_response_bytes: Option<u64>

Maximum bytes accepted for a single HTTP/SSE JSON-RPC response body, enforced at read time before the body is parsed or any embedded resource is materialized. A compromised or misbehaving server cannot force an unbounded response-body allocation. This is the encoded wire cap, not the decoded materialization budget: None/0 uses the built-in default of 16,078,168 bytes, sized so a full 10 MiB decoded embedded-resource blob (its base64 expansion plus JSON-RPC envelope headroom) still fits. The separate 10 MiB figure is the decoded aggregate blob budget applied after parsing, not this wire cap.

pinned_resources: Vec<String>

Resource URIs to read once at agent startup and inject into the system prompt as untrusted, server-origin context. Each is read via resources/read on this server; pins on a server that does not advertise resources, or that the agent’s tool policy denies, are skipped with a warning. Read once per run (not refreshed; no subscriptions).

tls_ca_cert_path: Option<String>

Absolute path to a PEM-encoded CA certificate or bundle to trust in addition to the default roots for this server’s HTTP/SSE transport.

Certificate and hostname verification remain enabled. The path must name a regular file no larger than 1 MiB; a missing, unreadable, empty, oversized, non-regular, or invalid file is a hard connection error rather than a fallback to the default trust store. When set, the configured URL and any advertised SSE message endpoint must use HTTPS; plaintext URLs and downgrade redirects are rejected. Ignored by stdio.

Implementations

impl McpServerConfig

pub fn configurable_prefix() -> &'static str

Returns the #[prefix] value for this Configurable struct.

pub fn init_requires_explicit_config() -> bool

True when this struct has a required leaf field that a bare/ancestor-prefix init_defaults scaffold must not materialize (it would fill the field with its Rust Default, which prune_empty_leaves then strips on save, leaving a partial sub-table that fails strict reload). Explicitly targeting this section (or a descendant of it) still scaffolds regardless of this flag, so the section can be materialized for the operator to fill in.

pub fn secret_fields(&self) -> Vec<SecretFieldInfo>

Returns metadata about all #[secret] fields on this struct and nested children.

pub fn secret_field_terminals() -> Vec<&'static str>

pub fn encrypt_secrets(&mut self, store: &SecretStore) -> Result<(), Error>

Encrypt all secret fields in place using the provided store.

pub fn decrypt_secrets(&mut self, store: &SecretStore) -> Result<(), Error>

Decrypt all secret fields in place using the provided store.

pub fn set_secret(&mut self, name: &str, value: String) -> Result<(), Error>

Set a secret field by its full dotted name, dispatching to nested children.

pub fn prop_fields(&self) -> Vec<PropFieldInfo>

Returns metadata about all property fields on this struct and nested children.

pub fn get_prop(&self, name: &str) -> Result<String, Error>

Get a property value by its full dotted name, returning it as a display string.

pub fn set_prop(&mut self, name: &str, value_str: &str) -> Result<(), Error>

Set a property value by its full dotted name, parsing from string.

pub fn prop_is_secret(name: &str) -> bool

Check if a property name refers to a secret field (static, no instance needed).

pub fn init_defaults(&mut self, prefix: Option<&str>) -> Vec<&'static str>

Instantiate None nested sections whose prefix matches. Returns the prefixes that were initialized.

pub fn map_key_sections() -> Vec<MapKeySection>

Enumerate every map-keyed (HashMap<String, T>) and list-shaped (Vec<T>) section discoverable from this Configurable’s tree. The dashboard / CLI consume this to surface “+ Add” affordances without hardcoding the section list.

pub fn nested_section_help(name: &str) -> Option<&'static str>

Help blurb for a #[nested] field on this struct, sourced from the field-level /// docstring. Returns None for unknown names so callers can fall through to a different lookup.

pub fn nested_section_group(name: &str) -> Option<&'static str>

pub fn get_map_keys(&self, section_path: &str) -> Option<Vec<String>>

Return the current alias keys at section_path, or None if the path doesn’t resolve to a map-keyed section in this tree.

pub fn nested_option_entries(&self) -> Vec<NestedOptionEntry>

pub fn create_map_key( &mut self, section_path: &str, map_key: &str, ) -> Result<bool, String>

pub fn delete_map_key( &mut self, section_path: &str, map_key: &str, ) -> Result<bool, String>

pub fn rename_map_key( &mut self, section_path: &str, map_key: &str, new_key: &str, ) -> Result<bool, String>

Trait Implementations

impl Clone for McpServerConfig

fn clone(&self) -> McpServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McpServerConfig

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

Formats the value using the given formatter.

impl Default for McpServerConfig

fn default() -> McpServerConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for McpServerConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<McpServerConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for McpServerConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl MaskSecrets for McpServerConfig

fn mask_secrets(&mut self)

fn restore_secrets_from(&mut self, current: &McpServerConfig)

impl Serialize for McpServerConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.