Struct RequestContext 

pub struct RequestContext { /* private fields */ }

Context information for an MCP request.

Implementations

impl RequestContext

pub fn new() -> Self

Create a new request context with a generated UUID.

pub fn with_session(self, session: Arc<dyn McpSession>) -> Self

Set the session handle for bidirectional communication.

pub async fn elicit_form( &self, message: impl Into<String>, schema: Value, ) -> McpResult<ElicitResult>

Request user input via a form.

pub async fn elicit_url( &self, message: impl Into<String>, url: impl Into<String>, elicitation_id: impl Into<String>, ) -> McpResult<ElicitResult>

Request user action via a URL.

pub async fn sample( &self, request: CreateMessageRequest, ) -> McpResult<CreateMessageResult>

Request LLM sampling from the client.

pub fn stdio() -> Self

Create a new request context for STDIO transport.

pub fn http() -> Self

Create a new request context for HTTP transport.

pub fn websocket() -> Self

Create a new request context for WebSocket transport.

pub fn tcp() -> Self

Create a new request context for TCP transport.

pub fn unix() -> Self

Create a new request context for Unix socket transport.

pub fn wasm() -> Self

Create a new request context for WASM transport.

pub fn channel() -> Self

Create a new request context for in-process channel transport.

pub fn with_id(id: impl Into<String>) -> Self

Create a new request context with a specific request ID.

pub fn with_transport(self, transport: TransportType) -> Self

Set the transport type.

pub fn with_headers(self, headers: HashMap<String, String>) -> Self

Set the HTTP headers.

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

Set the user ID.

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

Set the session ID.

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

Set the client ID.

pub fn with_metadata( self, key: impl Into<String>, value: impl Into<Value>, ) -> Self

Add a metadata key-value pair.

pub fn with_cancellation_token(self, token: Arc<CancellationToken>) -> Self

Set the cancellation token.

pub fn request_id(&self) -> &str

Get the request ID.

pub fn transport(&self) -> TransportType

Get the transport type.

pub fn headers(&self) -> Option<&HashMap<String, String>>

Get all HTTP headers.

pub fn header(&self, name: &str) -> Option<&str>

Get a specific HTTP header (case-insensitive).

pub fn user_id(&self) -> Option<&str>

Get the user ID.

pub fn session_id(&self) -> Option<&str>

Get the session ID.

pub fn client_id(&self) -> Option<&str>

Get the client ID.

pub fn get_metadata(&self, key: &str) -> Option<&Value>

Get a metadata value.

pub fn elapsed(&self) -> Duration

Get the elapsed time since request processing started.

pub fn is_cancelled(&self) -> bool

Check if the request has been cancelled.

pub fn is_authenticated(&self) -> bool

Check if the user is authenticated.

pub fn to_core_context(&self) -> RequestContext

Convert to the core RequestContext type.

This method creates a minimal context compatible with the unified turbomcp_core::McpHandler trait. Headers and auth fields are encoded as metadata with standard prefixes.

Trait Implementations

impl Clone for RequestContext

fn clone(&self) -> RequestContext

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RequestContext

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

Formats the value using the given formatter.

impl Default for RequestContext

fn default() -> Self

Returns the “default value” for a type.