Struct ServerConfig 

pub struct ServerConfig {
    pub transport: TransportType,
    pub command: String,
    pub args: Vec<String>,
    pub env: HashMap<String, String>,
    pub cwd: Option<PathBuf>,
    pub url: Option<String>,
    pub headers: HashMap<String, String>,
}

MCP server configuration with command, arguments, and environment.

Represents the configuration needed to communicate with an MCP server, supporting both stdio (subprocess) and HTTP transports.

Transport Types

• Stdio: Launches a subprocess and communicates via stdin/stdout
• HTTP: Connects to an HTTP/HTTPS API endpoint

Security

This type is designed to be safe by construction. Use the builder pattern to construct instances, and call validate_server_config before execution to ensure security requirements are met.

Examples

use mcp_execution_core::ServerConfig;

// Stdio transport
let config = ServerConfig::builder()
    .command("docker".to_string())
    .arg("run".to_string())
    .arg("mcp-server".to_string())
    .build();

assert_eq!(config.command, "docker");
assert_eq!(config.args.len(), 2);

// HTTP transport
let config = ServerConfig::builder()
    .http_transport("https://api.example.com/mcp".to_string())
    .header("Authorization".to_string(), "Bearer token".to_string())
    .build();

Fields

transport: TransportType

Transport type (stdio or http).

Determines how the client communicates with the MCP server.

command: String

Command to execute (binary name or absolute path).

Only used for stdio transport.

Can be either:

• Binary name (e.g., “docker”, “python”) - resolved via PATH
• Absolute path (e.g., “/usr/local/bin/mcp-server”)

args: Vec<String>

Arguments to pass to command.

Only used for stdio transport.

Each argument is passed separately to avoid shell interpretation. Do not include the command itself in arguments.

env: HashMap<String, String>

Environment variables to set for the subprocess.

Only used for stdio transport.

These are added to (or override) the parent process environment. Security validation blocks dangerous variables like LD_PRELOAD.

cwd: Option<PathBuf>

Working directory for the subprocess (optional).

Only used for stdio transport.

If None, inherits the parent process working directory.

url: Option<String>

URL for HTTP transport.

Only used for HTTP transport.

Example: https://api.example.com/mcp

headers: HashMap<String, String>

HTTP headers for HTTP transport.

Only used for HTTP transport.

Common headers include:

• Authorization: Authentication token
• Content-Type: Request content type

Implementations

impl ServerConfig

pub fn builder() -> ServerConfigBuilder

Creates a new builder for ServerConfig.

Examples

use mcp_execution_core::ServerConfig;

let config = ServerConfig::builder()
    .command("docker".to_string())
    .build();

pub const fn transport(&self) -> &TransportType

Returns the transport type.

pub fn command(&self) -> &str

Returns the command as a string slice.

pub fn args(&self) -> &[String]

Returns a slice of arguments.

pub const fn env(&self) -> &HashMap<String, String>

Returns a reference to the environment variables map.

pub const fn cwd(&self) -> Option<&PathBuf>

Returns the working directory, if set.

pub fn url(&self) -> Option<&str>

Returns the URL for HTTP transport, if set.

pub const fn headers(&self) -> &HashMap<String, String>

Returns a reference to the HTTP headers map.

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServerConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ServerConfig

fn eq(&self, other: &ServerConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ServerConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ServerConfig

impl StructuralPartialEq for ServerConfig