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() -> ResponseCachingMiddleware

Creates a new response caching middleware with default settings.

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

Sets the maximum number of cache entries.

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

Sets the maximum cache size in bytes.

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

Sets the maximum size per cache item in bytes.

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

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

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

Sets the TTL for call/get/read operations.

pub fn disable_tools_list(self) -> ResponseCachingMiddleware

Disables caching for tools/list.

pub fn disable_resources_list(self) -> ResponseCachingMiddleware

Disables caching for resources/list.

pub fn disable_prompts_list(self) -> ResponseCachingMiddleware

Disables caching for prompts/list.

pub fn disable_tools_call(self) -> ResponseCachingMiddleware

Disables caching for tools/call.

pub fn disable_resources_read(self) -> ResponseCachingMiddleware

Disables caching for resources/read.

pub fn disable_prompts_get(self) -> ResponseCachingMiddleware

Disables caching for prompts/get.

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

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

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

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<(), Error>

Formats the value using the given formatter.

impl Default for ResponseCachingMiddleware

fn default() -> ResponseCachingMiddleware

Returns the “default value” for a type.

impl Middleware for ResponseCachingMiddleware

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

Invoked before routing the request.

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

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.