Struct McpServerConfig 

pub struct McpServerConfig { /* private fields */ }

Validated independent MCP server configuration. Available with the mcp-server feature. Constructing this value does not bind a socket.

Examples

use tools_kit::mcp::McpServerConfig;
let config = McpServerConfig::new("127.0.0.1:8000".parse().unwrap(), "/mcp", "page")?;
assert!(serde_json::to_value(&config).unwrap().is_object());

Implementations

impl McpServerConfig

pub fn new( bind: SocketAddr, endpoint_path: impl Into<String>, cursor_prefix: impl Into<String>, ) -> Result<Self, ToolError>

Creates a validated loopback server configuration.

Errors

Returns ToolError::InvalidConfiguration unless the address is loopback with a nonzero port, the endpoint starts with / and contains no query or fragment, and the cursor prefix is nonblank.

Examples

use tools_kit::mcp::McpServerConfig;
let config = McpServerConfig::new("127.0.0.1:8000".parse().unwrap(), "/mcp", "page")?;
let value = serde_json::to_value(&config).unwrap();
assert_eq!(value["shutdown_timeout_secs"], 5);
assert_eq!(value["interaction_policy"], "reject_with_tool_error");

pub fn with_interaction_policy(self, policy: McpServerInteractionPolicy) -> Self

Selects how the server handles tool-requested caller interactions.

Examples

use tools_kit::mcp::McpServerConfig;
let config = McpServerConfig::new("127.0.0.1:8000".parse().unwrap(), "/mcp", "page")?;
let config = config.with_interaction_policy(tools_kit::mcp::McpServerInteractionPolicy::ElicitFormIfClientSupports);
let value = serde_json::to_value(&config).unwrap();
assert_eq!(value["shutdown_timeout_secs"], 5);
assert_eq!(value["interaction_policy"], "elicit_form_if_client_supports");

pub fn with_shutdown_timeout(self, timeout: Duration) -> Result<Self, ToolError>

Sets the nonzero deadline for joining server shutdown.

Errors

Returns ToolError::InvalidConfiguration for zero. Positive subsecond values become one second; other values use whole seconds. This bounds observation and never discards retained cleanup.

Examples

use tools_kit::mcp::McpServerConfig;
let config = McpServerConfig::new("127.0.0.1:8000".parse().unwrap(), "/mcp", "page")?;
assert!(config.clone().with_shutdown_timeout(std::time::Duration::ZERO).is_err());
let config = config.with_shutdown_timeout(std::time::Duration::from_secs(10))?;
let value = serde_json::to_value(&config).unwrap();
assert_eq!(value["shutdown_timeout_secs"], 10);
assert_eq!(value["interaction_policy"], "reject_with_tool_error");

Trait Implementations

impl Clone for McpServerConfig

fn clone(&self) -> Self

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

Formats the value using the given formatter.

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

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for McpServerConfig

impl PartialEq for McpServerConfig

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for McpServerConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for McpServerConfig