sandbox-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SMCP_CPUS | No | CPU cores limit per sandbox. | 2 |
| SMCP_HOST | No | Service listen address; recommend keeping 127.0.0.1. | 127.0.0.1 |
| SMCP_PORT | No | Service listen port; shared by /mcp and /files. | 8000 |
| SMCP_TOKEN | Yes | Bearer token for MCP access; required. Generate with `openssl rand -hex 32`. | |
| SMCP_URL_TTL | No | Validity period (seconds) for signed file URLs. | 3600 |
| SMCP_DATA_DIR | No | Directory for sandbox workspaces. | /var/lib/sandbox-mcp/data |
| SMCP_STATE_DB | No | Path to SQLite state database. | /var/lib/sandbox-mcp/state.db |
| SMCP_MEM_LIMIT | No | Memory limit per sandbox. | 2g |
| SMCP_BASE_IMAGE | No | Base Docker image for sandboxes. | ghcr.io/greenteodoro839/sandbox-mcp-base:latest |
| SMCP_PIDS_LIMIT | No | Process count limit per sandbox. | 512 |
| SMCP_JOB_TIMEOUT | No | Default timeout (seconds) for background jobs. | 3600 |
| SMCP_SIGNING_KEY | No | Separate HMAC signing key for file URLs; defaults to SMCP_TOKEN if not set. | = SMCP_TOKEN |
| SMCP_EXEC_TIMEOUT | No | Default timeout (seconds) for exec tool. | 60 |
| SMCP_MAX_SANDBOXES | No | Maximum number of simultaneous sandboxes. | 20 |
| SMCP_PUBLIC_BASE_URL | No | Public base URL for constructing signed file URLs; must be changed to your public HTTPS address. | http://127.0.0.1:8000 |
| SMCP_SANDBOX_NETWORK | No | Sandbox network mode; set to 'none' for no network. | bridge |
| SMCP_IDLE_STOP_SECONDS | No | Idle time (seconds) before stopping a sandbox container. | 7200 |
| SMCP_JOB_LOG_RETENTION | No | Retention time (seconds) for job logs. | 86400 |
| SMCP_GC_INTERVAL_SECONDS | No | GC check interval (seconds). | 300 |
| SMCP_IDLE_REMOVE_SECONDS | No | Idle time (seconds) before removing a sandbox and its files. | 604800 |
| SMCP_READ_TEXT_MAX_BYTES | No | Maximum bytes for inline read_text; larger files use download_url. | 200000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityInactive
ResponsivenessNo issues