Struct McpServer 

pub struct McpServer { /* private fields */ }

An MCP server that manages tools, resources, prompts, and dispatches calls.

Implementations

impl McpServer

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

Create a new MCP server with no authentication.

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

Require bearer token authentication for all requests.

pub fn with_generated_auth(self) -> (Self, String)

Generate and attach a random bearer token.

Returns the generated token so the caller can distribute it.

pub fn check_auth(&self, authorization_header: &str) -> bool

Validate an Authorization header value. Always returns true when no auth is configured.

pub fn auth_enabled(&self) -> bool

Returns true if bearer authentication is enabled on this server.

pub fn register_tool(&mut self, tool: ToolDescription)

Register a tool with the server.

pub fn register_resource(&mut self, resource: ResourceDescription)

Register a resource with the server.

pub fn set_handler( &mut self, tool_name: &str, handler: impl Fn(Value) -> Result<Value> + Send + Sync + 'static, )

Set the handler for a tool by name.

pub fn set_async_handler<F, Fut>(&mut self, tool_name: &str, handler: F)

where F: Fn(Value) -> Fut + Send + Sync + 'static, Fut: Future<Output = Result<Value>> + Send,

Register an async handler for a tool by name.

handler is a closure returning a future (typically async move { … }). Async handlers take precedence over sync handlers registered with Self::set_handler when resolved via Self::call_tool_async.

pub fn name(&self) -> &str

Get the server name.

pub fn version(&self) -> &str

Get the server version.

pub fn tools(&self) -> &[ToolDescription]

List all registered tools.

pub fn resources(&self) -> &[ResourceDescription]

List all registered resources.

pub fn set_resource_handler( &mut self, uri: &str, handler: impl Fn(Value) -> Result<Value> + Send + Sync + 'static, )

Set the handler for a resource by URI.

pub fn read_resource(&self, uri: &str, params: Value) -> Result<Value>

Read a resource by URI with the given parameters.

pub fn register_prompt(&mut self, prompt: PromptDescription)

Register a prompt with the server.

pub fn set_prompt_handler( &mut self, prompt_name: &str, handler: impl Fn(Value) -> Result<Value> + Send + Sync + 'static, )

Set the handler for a prompt by name.

The handler receives the prompts/get arguments object and returns the result value — typically { "description": ..., "messages": [...] }.

pub fn prompts(&self) -> &[PromptDescription]

List all registered prompts.

pub fn get_prompt(&self, name: &str, params: Value) -> Result<Value>

Render a prompt by name with the given arguments.

pub fn has_tool(&self, name: &str) -> bool

Whether a tool with name is registered (has a sync or async handler).

Lets a transport distinguish an unknown tool (a protocol-level invalid params error) from a tool that ran and failed (reported in-band with isError: true).

pub fn call_tool(&self, name: &str, params: Value) -> Result<Value>

Call a tool by name with the given parameters.

pub async fn call_tool_async(&self, name: &str, params: Value) -> Result<Value>

Call a tool by name, awaiting an async handler if one is registered and otherwise falling back to the synchronous handler. Errors if the tool is unknown. This is the entry point used by async transports (e.g. HTTP/SSE).

pub fn negotiate_protocol_version( &self, requested: Option<&str>, ) -> &'static str

Resolve the protocol version to report in initialize.

Echoes requested when it is one of SUPPORTED_PROTOCOL_VERSIONS; otherwise returns LATEST_PROTOCOL_VERSION (per the MCP spec, the server proposes its own latest when it cannot honor the client’s).

pub fn initialize_response(&self, requested_version: Option<&str>) -> Value

Build the initialize response, negotiating the protocol version against the client’s requested version.

The advertised capabilities reflect what the server actually supports: tools and resources are always present; prompts is included only when at least one prompt is registered.

impl McpServer

pub fn format_notification(&self, notification: McpNotification) -> String

Format a notification as a JSON-RPC message string.