Struct HttpServerConfig 

pub struct HttpServerConfig {
    pub health_path: String,
    pub max_connections: usize,
    pub handler_config: HttpHandlerConfig,
    pub request_capacity: usize,
    pub legacy_sse_path: String,
    pub legacy_message_path: String,
}

Configuration for the live HTTP listener used by Server::run_http.

The listener serves modern Streamable HTTP at Self::mcp_path. Enabling the dated legacy feature additionally exposes the exact MCP 2024-11-05 SSE and message POST routes. It runs on the caller-owned asupersync context and does not create a runtime of its own.

Example

use fastmcp_server::HttpServerConfig;

let config = HttpServerConfig::new()
    .mcp_path("/api/mcp")
    .health_path("/healthz")
    .max_connections(128);

Fields

health_path: String

Path for the health-check endpoint (default: "/health").

max_connections: usize

Maximum number of concurrent connections (default: 64).

handler_config: HttpHandlerConfig

Inner HTTP handler configuration (endpoint path, CORS, and body size).

request_capacity: usize

Maximum requests buffered for one live HTTP session.

legacy_sse_path: String

GET path for the exact MCP 2024-11-05 SSE stream.

legacy_message_path: String

POST path advertised to an exact MCP 2024-11-05 SSE client.

Implementations

impl HttpServerConfig

pub fn new() -> Self

Creates a new configuration with default values.

pub fn mcp_path(self, path: impl Into<String>) -> Self

Sets the MCP endpoint path.

pub fn health_path(self, path: impl Into<String>) -> Self

Sets the health-check endpoint path.

pub fn max_connections(self, max: usize) -> Self

Sets the maximum number of concurrent connections.

pub fn handler_config(self, config: HttpHandlerConfig) -> Self

Sets the inner HTTP handler configuration.

pub fn request_capacity(self, capacity: usize) -> Self

Sets the per-session HTTP request queue capacity.

pub fn legacy_sse_path(self, path: impl Into<String>) -> Self

Sets the exact MCP 2024-11-05 SSE stream path.

pub fn legacy_message_path(self, path: impl Into<String>) -> Self

Sets the exact MCP 2024-11-05 POST path advertised through SSE.

Trait Implementations

impl Clone for HttpServerConfig

fn clone(&self) -> HttpServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpServerConfig

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

Formats the value using the given formatter.

impl Default for HttpServerConfig

fn default() -> Self

Returns the “default value” for a type.