Skip to main content
View the source code for this module on GitHub: https://github.com/mcp-use/mcp-use/blob/main/mcp_use/connectors/sandbox.py
Sandbox connector for MCP implementations. This module provides a connector for communicating with MCP implementations that are executed inside a sandbox environment (currently using E2B).

​
SandboxConnector

from mcp_use.connectors.sandbox import SandboxConnector

​
method init

Initialize a new sandbox connector.Parameters
​
command
str
required
String value
​
args
list[str]
required
List of items
​
env
dict[str, str] | None
default:"None"
Environment variables for the user’s MCP server command.
​
e2b_options
mcp_use.types.sandbox.SandboxOptions | None
default:"None"
Configuration options for the E2B sandbox environment.
​
timeout
float
default:"5"
Timeout for the sandbox process in seconds.
​
sse_read_timeout
float
default:"300"
Timeout for the SSE connection in seconds.
​
sampling_callback
mcp.client.session.SamplingFnT | None
default:"None"
Optional sampling callback.
​
elicitation_callback
mcp.client.session.ElicitationFnT | None
default:"None"
Optional elicitation callback.
​
message_handler
mcp.client.session.MessageHandlerFnT | None
default:"None"
Parameter value
​
logging_callback
mcp.client.session.LoggingFnT | None
default:"None"
Callback function
​
middleware
list[mcp_use.middleware.middleware.Middleware] | None
default:"None"
Middleware instance
Signature
def __init__(command: str, args: list[str], env: dict[str, str] | None = None, e2b_options: mcp_use.types.sandbox.SandboxOptions | None = None, timeout: float = 5, sse_read_timeout: float = 300, 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.middleware.middleware.Middleware] | None = None):

​
method wait_for_server_response

Wait for the server to respond to HTTP requests.Parameters
​
base_url
str
required
The base URL to check for server readiness
​
timeout
int
default:"30"
Maximum time to wait in seconds
Returns
​
returns
bool
True if server is responding, raises TimeoutError otherwise
Signature
def wait_for_server_response(base_url: str, timeout: int = 30):
⌘I