Struct ServerBuilder 

pub struct ServerBuilder<H, Tools, Resources, Prompts, Tasks> { /* private fields */ }

Builder for constructing MCP servers with specific capabilities.

Uses the typestate pattern with 5 type parameters to track registered handlers at compile time:

• H: Base server handler (always required)
• Tools: Tool handler state
• Resources: Resource handler state
• Prompts: Prompt handler state
• Tasks: Task handler state

When a capability is not registered, its type parameter is NotRegistered. When registered, it becomes Registered<T> where T is the handler type.

Implementations

impl<H> ServerBuilder<H, NotRegistered, NotRegistered, NotRegistered, NotRegistered>

where H: ServerHandler,

pub fn new( handler: H, ) -> ServerBuilder<H, NotRegistered, NotRegistered, NotRegistered, NotRegistered>

Create a new server builder with the given base handler.

The base handler must implement ServerHandler and provides the core server identity and configuration.

impl<H, T, R, P, K> ServerBuilder<H, T, R, P, K>

where H: ServerHandler,

pub fn capabilities( self, caps: ServerCapabilities, ) -> ServerBuilder<H, T, R, P, K>

Override the capabilities advertised by this server.

By default, capabilities are derived from the base handler. Use this to customize or extend those capabilities.

pub const fn get_capabilities(&self) -> &ServerCapabilities

Get a reference to the current capabilities.

impl<H, R, P, K> ServerBuilder<H, NotRegistered, R, P, K>

where H: ServerHandler,

pub fn with_tools<TH>( self, tools: TH, ) -> ServerBuilder<H, Registered<TH>, R, P, K>

where TH: ToolHandler,

Register a tool handler.

This method is only available when no tool handler has been registered yet. Attempting to register tools twice will result in a compile error.

impl<H, T, P, K> ServerBuilder<H, T, NotRegistered, P, K>

where H: ServerHandler,

pub fn with_resources<RH>( self, resources: RH, ) -> ServerBuilder<H, T, Registered<RH>, P, K>

where RH: ResourceHandler,

Register a resource handler.

This method is only available when no resource handler has been registered yet.

impl<H, T, R, K> ServerBuilder<H, T, R, NotRegistered, K>

where H: ServerHandler,

pub fn with_prompts<PH>( self, prompts: PH, ) -> ServerBuilder<H, T, R, Registered<PH>, K>

where PH: PromptHandler,

Register a prompt handler.

This method is only available when no prompt handler has been registered yet.

impl<H, T, R, P> ServerBuilder<H, T, R, P, NotRegistered>

where H: ServerHandler,

pub fn with_tasks<KH>( self, tasks: KH, ) -> ServerBuilder<H, T, R, P, Registered<KH>>

where KH: TaskHandler,

Register a task handler.

Tasks are long-running operations that can be tracked, monitored, and cancelled.

This method is only available when no task handler has been registered yet.

impl<H, T, R, P, K> ServerBuilder<H, T, R, P, K>

where H: ServerHandler + Send + Sync + 'static, T: Send + Sync + 'static, R: Send + Sync + 'static, P: Send + Sync + 'static, K: Send + Sync + 'static,

pub fn build(self) -> Server<H, T, R, P, K>

Build the server.

Returns a Server configured with the registered handlers and capabilities.