Skip to main content
View the source code for this module on GitHub: https://github.com/mcp-use/mcp-use/blob/main/libraries/python/mcp_use/client/connectors/stdio.py
StdIO connector for MCP implementations. This module provides a connector for communicating with MCP implementations through the standard input/output streams.

​
StdioConnector

from mcp_use.client.connectors.stdio import StdioConnector

​
method init

Initialize a new stdio connector.Parameters
​
command
str
default:"npx"
String value
​
args
list[str] | None
default:"None"
List of items
​
env
dict[str, str] | None
default:"None"
Optional environment variables.
​
errlog
Stream to write error output to.
​
sampling_callback
mcp.client.session.SamplingFnT | None
default:"None"
Optional callback to sample the client.
​
elicitation_callback
mcp.client.session.ElicitationFnT | None
default:"None"
Optional callback to elicit the client.
​
message_handler
mcp.client.session.MessageHandlerFnT | None
default:"None"
Optional callback to handle messages.
​
logging_callback
mcp.client.session.LoggingFnT | None
default:"None"
Optional callback to handle log messages.
​
middleware
list[mcp_use.client.middleware.middleware.Middleware] | None
default:"None"
Optional list of middleware.
​
roots
list[mcp.types.Root] | None
default:"None"
Optional initial list of roots to advertise to the server.
​
list_roots_callback
mcp.client.session.ListRootsFnT | None
default:"None"
Optional custom callback to handle roots/list requests.
Signature
def __init__(command: str = "npx", args: list[str] | None = None, env: dict[str, str] | None = None, errlog = <_io.TextIOWrapper name='<stderr>' mode='w' encoding='utf-8'>, sampling_callback: mcp.client.session.SamplingFnT | None = None, elicitation_callback: mcp.client.session.ElicitationFnT | None = None, message_handler: mcp.client.session.MessageHandlerFnT | None = None, logging_callback: mcp.client.session.LoggingFnT | None = None, middleware: list[mcp_use.client.middleware.middleware.Middleware] | None = None, roots: list[mcp.types.Root] | None = None, list_roots_callback: mcp.client.session.ListRootsFnT | None = None):