Struct McpServerBuilder 

pub struct McpServerBuilder { /* private fields */ }

Builder for McpServer — the main entry point for configuring your server.

Implementations

impl McpServerBuilder

pub fn new() -> Self

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

Set the server name (shown to clients during handshake)

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

Set the server version

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

Human-readable instructions for how to use this server

pub fn auth(self, provider: DynAuthProvider) -> Self

Require authentication on all requests using the given provider.

Requests with no or invalid credentials receive HTTP 401 on SSE/HTTP transports. Stdio transport is unaffected (it relies on process-level access control).

Example

use mcp_kit::prelude::*;
use mcp_kit::auth::BearerTokenProvider;
use std::sync::Arc;

McpServer::builder()
    .name("my-server")
    .version("1.0")
    .auth(Arc::new(BearerTokenProvider::new(["secret"])))
    .build();

pub fn optional_auth(self, provider: DynAuthProvider) -> Self

Accept an auth provider but allow unauthenticated requests through.

Authenticated requests have an identity available via Auth; unauthenticated requests have no identity and may reach handlers with None.

pub fn tool<M>(self, tool: Tool, handler: impl ToolHandler<M>) -> Self

Register a tool with an explicit Tool descriptor and a handler function.

pub fn tool_def(self, def: ToolDef) -> Self

Register a tool using a pre-built ToolDef (from the #[tool] macro).

pub fn tool_fn<M>( self, name: impl Into<String>, description: impl Into<String>, handler: impl ToolHandler<M>, ) -> Self

Convenience: register a no-parameter tool.

pub fn resource<M>( self, resource: Resource, handler: impl ResourceHandler<M>, ) -> Self

Register a static resource (exact URI match).

pub fn resource_template<M>( self, template: ResourceTemplate, handler: impl ResourceHandler<M>, ) -> Self

Register a URI-template resource (e.g. "file://{path}").

pub fn resource_def(self, def: ResourceDef) -> Self

Register a resource using a pre-built ResourceDef (from the #[resource] macro).

pub fn prompt<M>(self, prompt: Prompt, handler: impl PromptHandler<M>) -> Self

Register a prompt template.

pub fn prompt_def(self, def: PromptDef) -> Self

Register a prompt using a pre-built PromptDef (from the #[prompt] macro).

pub fn build(self) -> McpServer

Trait Implementations

impl Default for McpServerBuilder

fn default() -> Self

Returns the “default value” for a type.