Middleware

View the source code for this module on GitHub: https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/server/middleware/middleware.py

CallNext

from mcp_use.server.middleware.middleware import CallNext

`method` init

Parameters

required
Parameter value

required
Parameter value

Signature

def __init__(args, kwargs):

`method` call

Parameters

ServerMiddlewareContext[T]
required
Parameter value

Returns

Awaitable[R]

Signature

def __call__(context: ServerMiddlewareContext[T]):

from mcp_use.server.middleware.middleware import Middleware

`method` call

Parameters

ServerMiddlewareContext[T]
required
Parameter value

CallNext[T, Any]
required
Parameter value

Returns

Any

Signature

def __call__(context: ServerMiddlewareContext[T], call_next: CallNext[T, Any]):

`method` on_call_tool

Parameters

ServerMiddlewareContext[CallToolRequestParams]
required
Parameter value

CallNext[CallToolRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_call_tool(
context: ServerMiddlewareContext[CallToolRequestParams],
    call_next: CallNext[CallToolRequestParams,
    Any]
):

`method` on_complete

Parameters

ServerMiddlewareContext[CompleteRequestParams]
required
Parameter value

CallNext[CompleteRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_complete(
context: ServerMiddlewareContext[CompleteRequestParams],
    call_next: CallNext[CompleteRequestParams,
    Any]
):

`method` on_get_prompt

Parameters

ServerMiddlewareContext[GetPromptRequestParams]
required
Parameter value

CallNext[GetPromptRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_get_prompt(
context: ServerMiddlewareContext[GetPromptRequestParams],
    call_next: CallNext[GetPromptRequestParams,
    Any]
):

`method` on_initialize

Parameters

ServerMiddlewareContext[InitializeRequestParams]
required
Parameter value

CallNext[InitializeRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_initialize(
context: ServerMiddlewareContext[InitializeRequestParams],
    call_next: CallNext[InitializeRequestParams,
    Any]
):

`method` on_list_prompts

Parameters

ServerMiddlewareContext[PaginatedRequestParams | None]
required
Parameter value

CallNext[PaginatedRequestParams | None, Any]
required
Parameter value

Returns

Any

Signature

def on_list_prompts(
context: ServerMiddlewareContext[PaginatedRequestParams | None],
    call_next: CallNext[PaginatedRequestParams | None,
    Any]
):

`method` on_list_resources

Parameters

ServerMiddlewareContext[PaginatedRequestParams | None]
required
Parameter value

CallNext[PaginatedRequestParams | None, Any]
required
Parameter value

Returns

Any

Signature

def on_list_resources(
context: ServerMiddlewareContext[PaginatedRequestParams | None],
    call_next: CallNext[PaginatedRequestParams | None,
    Any]
):

`method` on_list_tools

Parameters

ServerMiddlewareContext[PaginatedRequestParams | None]
required
Parameter value

CallNext[PaginatedRequestParams | None, Any]
required
Parameter value

Returns

Any

Signature

def on_list_tools(
context: ServerMiddlewareContext[PaginatedRequestParams | None],
    call_next: CallNext[PaginatedRequestParams | None,
    Any]
):

`method` on_read_resource

Parameters

ServerMiddlewareContext[ReadResourceRequestParams]
required
Parameter value

CallNext[ReadResourceRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_read_resource(
context: ServerMiddlewareContext[ReadResourceRequestParams],
    call_next: CallNext[ReadResourceRequestParams,
    Any]
):

`method` on_request

Parameters

ServerMiddlewareContext[Any]
required
Parameter value

CallNext[Any, Any]
required
Parameter value

Returns

Any

Signature

def on_request(context: ServerMiddlewareContext[Any], call_next: CallNext[Any, Any]):

`method` on_set_logging_level

Parameters

ServerMiddlewareContext[SetLevelRequestParams]
required
Parameter value

CallNext[SetLevelRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_set_logging_level(
context: ServerMiddlewareContext[SetLevelRequestParams],
    call_next: CallNext[SetLevelRequestParams,
    Any]
):

`method` on_subscribe_resource

Parameters

ServerMiddlewareContext[SubscribeRequestParams]
required
Parameter value

CallNext[SubscribeRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_subscribe_resource(
context: ServerMiddlewareContext[SubscribeRequestParams],
    call_next: CallNext[SubscribeRequestParams,
    Any]
):

`method` on_unsubscribe_resource

Parameters

ServerMiddlewareContext[UnsubscribeRequestParams]
required
Parameter value

CallNext[UnsubscribeRequestParams, Any]
required
Parameter value

Returns

Any

Signature

def on_unsubscribe_resource(
context: ServerMiddlewareContext[UnsubscribeRequestParams],
    call_next: CallNext[UnsubscribeRequestParams,
    Any]
):

MiddlewareManager

from mcp_use.server.middleware.middleware import MiddlewareManager

`method` init

Signature

def __init__():

`method` add_middleware

Parameters

Middleware
required
Middleware instance

Signature

def add_middleware(middleware: Middleware):

`method` process_request

Parameters

ServerMiddlewareContext[Any]
required
Parameter value

Callable[[ServerMiddlewareContext[Any]], Awaitable[Any]]
required
Parameter value

Returns

Any

Signature

def process_request(
context: ServerMiddlewareContext[Any],
    handler: Callable[[ServerMiddlewareContext[Any]],
    Awaitable[Any]]
):

ServerMiddlewareContext

from mcp_use.server.middleware.middleware import ServerMiddlewareContext

Attributes

required

Parameter value

str

required

String value

datetime

required

Parameter value

str

required

String value

str | None

required

MCP session instance

dict[str, str] | None

required

Dictionary of key-value pairs

str | None

required

MCP client instance

dict[str, Any]

required

Dictionary of key-value pairs

`method` init

Parameters

T
required
Parameter value

str
required
String value

datetime
required
Parameter value

str
required
String value

str | None
default:"None"
MCP session instance

dict[str, str] | None
default:"None"
Dictionary of key-value pairs

str | None
default:"None"
MCP client instance

dict[str, Any]
default:"<factory>"
Dictionary of key-value pairs

Signature

def __init__(message: T, method: str, timestamp: datetime, transport: str, session_id: str | None = None, headers: dict[str, str] | None = None, client_ip: str | None = None, metadata: dict[str, Any] = <factory>):

`method` copy

Parameters

Any
required
Parameter value

Returns

ServerMiddlewareContext[T]

Signature

def copy(kwargs: Any):

ServerResponseContext

from mcp_use.server.middleware.middleware import ServerResponseContext

Attributes

R | None

required

Parameter value

Exception | None

required

Parameter value

dict[str, Any]

required

Dictionary of key-value pairs

`method` init

Parameters

R | None
default:"None"
Parameter value

Exception | None
default:"None"
Parameter value

dict[str, Any]
default:"<factory>"
Dictionary of key-value pairs

Signature

def __init__(result: R | None = None, error: Exception | None = None, metadata: dict[str, Any] = <factory>):

Agents

Client

Core

Errors

Server

Middleware

CallNext

`method` init

`method` call

Middleware

`method` call

`method` on_call_tool

`method` on_complete

`method` on_get_prompt

`method` on_initialize

`method` on_list_prompts

`method` on_list_resources

`method` on_list_tools

`method` on_read_resource

`method` on_request

`method` on_set_logging_level

`method` on_subscribe_resource

`method` on_unsubscribe_resource

MiddlewareManager

`method` init

`method` add_middleware

`method` process_request

ServerMiddlewareContext

`method` init

`method` copy

ServerResponseContext

`method` init

​CallNext

​method init

​method call

​Middleware

​method call

​method on_call_tool

​method on_complete

​method on_get_prompt

​method on_initialize

​method on_list_prompts

​method on_list_resources

​method on_list_tools

​method on_read_resource

​method on_request

​method on_set_logging_level

​method on_subscribe_resource

​method on_unsubscribe_resource

​MiddlewareManager

​method init

​method add_middleware

​method process_request

​ServerMiddlewareContext

​method init

​method copy

​ServerResponseContext

​method init

CallNext

`method` init

`method` call

Middleware

`method` call

`method` on_call_tool

`method` on_complete

`method` on_get_prompt

`method` on_initialize

`method` on_list_prompts

`method` on_list_resources

`method` on_list_tools

`method` on_read_resource

`method` on_request

`method` on_set_logging_level

`method` on_subscribe_resource

`method` on_unsubscribe_resource

MiddlewareManager

`method` init

`method` add_middleware

`method` process_request

ServerMiddlewareContext

`method` init

`method` copy

ServerResponseContext

`method` init