Struct ServerBuilder 

pub struct ServerBuilder<H: McpHandler> { /* private fields */ }

Server builder for configuring and running MCP servers.

This builder provides a fluent API for:

• Selecting transport at runtime
• Configuring rate limits and connection limits
• Setting up graceful shutdown
• Integrating with existing server infrastructure

Example

use turbomcp::prelude::*;

MyServer.builder()
    .transport(Transport::http("0.0.0.0:8080"))
    .with_rate_limit(100, Duration::from_secs(1))
    .serve()
    .await?;

Implementations

impl<H: McpHandler> ServerBuilder<H>

pub fn new(handler: H) -> Self

Create a new server builder wrapping the given handler.

pub fn transport(self, transport: Transport) -> Self

Set the transport for this server.

Example

builder.transport(Transport::http("0.0.0.0:8080"))

pub fn with_rate_limit(self, max_requests: u32, window: Duration) -> Self

Configure rate limiting.

Arguments

• requests - Maximum requests allowed
• per - Time window for the limit

Example

// Allow 100 requests per second
builder.with_rate_limit(100, Duration::from_secs(1))

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

Configure maximum concurrent connections.

This limit applies to TCP, HTTP, WebSocket, and Unix transports. STDIO transport always has exactly one connection.

Example

builder.with_connection_limit(1000)

pub fn with_graceful_shutdown(self, timeout: Duration) -> Self

Configure graceful shutdown timeout.

When the server receives a shutdown signal, it will wait up to this duration for in-flight requests to complete.

Example

builder.with_graceful_shutdown(Duration::from_secs(30))

pub fn with_max_message_size(self, size: usize) -> Self

Configure maximum message size.

Messages exceeding this size will be rejected. Default: 10MB.

Example

// Limit messages to 1MB
builder.with_max_message_size(1024 * 1024)

pub fn with_config(self, config: ServerConfig) -> Self

Apply a custom server configuration.

This replaces any previously set configuration options.

Example

let config = ServerConfig::builder()
    .rate_limit(rate_config)
    .connection_limits(limits)
    .build();

builder.with_config(config)

pub async fn serve(self) -> McpResult<()>

Run the server with the configured transport.

This is the main entry point that starts the server and blocks until shutdown.

Example

MyServer.builder()
    .transport(Transport::http("0.0.0.0:8080"))
    .serve()
    .await?;

pub fn handler(&self) -> &H

Get the underlying handler.

Useful for testing or custom integrations.

pub fn into_handler(self) -> H

Consume the builder and return the handler.

Useful for custom integrations where you need ownership.

Trait Implementations

impl<H: Debug + McpHandler> Debug for ServerBuilder<H>

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

Formats the value using the given formatter.