Struct SseServerBuilder 

pub struct SseServerBuilder { /* private fields */ }

Builder for creating SSE MCP servers

Provides a fluent API for configuring and building MCP proxy servers.

Example

use mcp_sse_proxy::server_builder::{SseServerBuilder, BackendConfig};

// Create a server with stdio backend
let (router, ct) = SseServerBuilder::new(BackendConfig::Stdio {
    command: "npx".into(),
    args: Some(vec!["-y".into(), "@modelcontextprotocol/server-filesystem".into()]),
    env: None,
})
.mcp_id("my-server")
.sse_path("/custom/sse")
.post_path("/custom/message")
.stateful(false)  // Disable stateful mode for OneShot services (faster responses)
.build()
.await?;

Implementations

impl SseServerBuilder

pub fn new(backend: BackendConfig) -> SseServerBuilder

Create a new builder with the given backend configuration

pub fn sse_path(self, path: impl Into<String>) -> SseServerBuilder

Set the SSE endpoint path

pub fn post_path(self, path: impl Into<String>) -> SseServerBuilder

Set the message endpoint path

pub fn mcp_id(self, id: impl Into<String>) -> SseServerBuilder

Set the MCP service identifier

Used for logging and service identification.

pub fn tool_filter(self, filter: ToolFilter) -> SseServerBuilder

Set the tool filter configuration

pub fn keep_alive(self, secs: u64) -> SseServerBuilder

Set the keep-alive interval in seconds

pub fn stateful(self, stateful: bool) -> SseServerBuilder

Set stateful mode (default: true)

When false, uses with_service_directly which skips MCP initialization for faster responses. This is recommended for OneShot services.

pub async fn build( self, ) -> Result<(Router, CancellationToken, SseHandler), Error>

Build the server and return an axum Router, CancellationToken, and SseHandler

The router can be merged with other axum routers or served directly. The CancellationToken can be used to gracefully shut down the service. The SseHandler can be used for status checks and management.