Struct ResponseCachingMiddleware 

pub struct ResponseCachingMiddleware { /* private fields */ }

Response caching middleware for MCP servers.

Caches responses for list and call operations with configurable TTL. Uses an LRU eviction strategy when the cache is full.

Implementations

impl ResponseCachingMiddleware

pub fn new() -> Self

Creates a new response caching middleware with default settings.

pub fn max_entries(self, max: usize) -> Self

Sets the maximum number of cache entries.

pub fn max_size_bytes(self, max: usize) -> Self

Sets the maximum cache size in bytes.

pub fn max_item_size(self, max: usize) -> Self

Sets the maximum size per cache item in bytes.

pub fn list_ttl_secs(self, secs: u64) -> Self

Sets the TTL for list operations (tools/list, resources/list, prompts/list).

pub fn call_ttl_secs(self, secs: u64) -> Self

Sets the TTL for call/get/read operations.

pub fn disable_tools_list(self) -> Self

Disables caching for tools/list.

pub fn disable_resources_list(self) -> Self

Disables caching for resources/list.

pub fn disable_prompts_list(self) -> Self

Disables caching for prompts/list.

pub fn disable_tools_call(self) -> Self

Disables caching for tools/call.

pub fn disable_resources_read(self) -> Self

Disables caching for resources/read.

pub fn disable_prompts_get(self) -> Self

Disables caching for prompts/get.

pub fn include_tools(self, tools: Vec<String>) -> Self

Sets the list of tools to include in caching (empty = all).

pub fn exclude_tools(self, tools: Vec<String>) -> Self

Sets the list of tools to exclude from caching.

pub fn stats(&self) -> CacheStats

Returns current cache statistics.

pub fn clear(&self)

Clears the entire cache.

pub fn invalidate(&self, method: &str, params: Option<&Value>)

Invalidates a specific cache entry by method and params.

Trait Implementations

impl Debug for ResponseCachingMiddleware

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

Formats the value using the given formatter.

impl Default for ResponseCachingMiddleware

fn default() -> Self

Returns the “default value” for a type.

impl Middleware for ResponseCachingMiddleware

fn on_request( &self, _ctx: &McpContext, request: &JsonRpcRequest, ) -> McpResult<MiddlewareDecision>

Invoked before routing the request.

fn on_response( &self, _ctx: &McpContext, request: &JsonRpcRequest, response: Value, ) -> McpResult<Value>

Invoked after a successful handler result is produced.

fn on_error( &self, _ctx: &McpContext, _request: &JsonRpcRequest, error: McpError, ) -> McpError

Invoked when a handler or middleware returns an error.