Struct RequestContext 

pub struct RequestContext<'a> { /* private fields */ }

Normalized request context across all transports (HTTP, Lambda, etc.)

Provides uniform access to request data regardless of transport mechanism.

Examples

use turul_http_mcp_server::middleware::RequestContext;
use serde_json::json;

let mut ctx = RequestContext::new(
    "tools/call",
    Some(json!({"name": "calculator"})),
);

ctx.add_metadata("user-agent", json!("Claude-Code/1.0"));

assert_eq!(ctx.method(), "tools/call");
assert!(ctx.params().is_some());
assert_eq!(ctx.metadata().get("user-agent").unwrap(), "Claude-Code/1.0");

Implementations

impl<'a> RequestContext<'a>

pub fn new(method: &'a str, params: Option<Value>) -> Self

Create a new request context

Parameters

• method: MCP method name (e.g., “tools/call”)
• params: Optional request parameters

pub fn method(&self) -> &str

Get the MCP method name

pub fn params(&self) -> Option<&Value>

Get request parameters (if any)

pub fn params_mut(&mut self) -> Option<&mut Value>

Get mutable request parameters

pub fn metadata(&self) -> &Map<String, Value>

Get transport metadata (read-only)

pub fn add_metadata(&mut self, key: impl Into<String>, value: Value)

Add metadata entry

Examples

use turul_http_mcp_server::middleware::RequestContext;
use serde_json::json;

let mut ctx = RequestContext::new("tools/call", None);
ctx.add_metadata("client-ip", json!("127.0.0.1"));

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

Get the Bearer token (if extracted from Authorization header)

pub fn set_bearer_token(&mut self, token: String)

Set the Bearer token (called by transport during extraction)

pub fn extensions(&self) -> &HashMap<String, Value>

Get request-scoped extensions (read-only)

pub fn set_extension(&mut self, key: impl Into<String>, value: Value)

Set an extension value (used by middleware to pass data to tools)

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

Get an extension value by key

pub fn take_extensions(&mut self) -> HashMap<String, Value>

Take ownership of extensions (used by transport to thread to SessionContext)

Trait Implementations

impl<'a> Clone for RequestContext<'a>

fn clone(&self) -> RequestContext<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RequestContext<'a>

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

Formats the value using the given formatter.