
What is mcp-sandboxd?
mcp-sandboxd is an MCP-compatible server that allows running arbitrary commands inside isolated sandboxes in Docker or Kubernetes.
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者

mcp-sandboxd?mcp-sandboxd is an MCP-compatible server that allows running arbitrary commands inside isolated sandboxes in Docker or Kubernetes.
MCP server for running commands in persistent, isolated sandboxes on Docker or Kubernetes
The core idea is simple: an identifier (e.g. a conversation id) maps to a long-running sandbox environment reused across runs. This makes agent workflows feel like a "real machine", without exposing your host.
/artifacts and download them via the server HTTP endpoint.run_sandbox: run one or more commands in a sandbox keyed by identifier.delete_sandbox: delete a sandbox environment.restart_sandbox: recreate a fresh sandbox for an identifier.Write files inside the sandbox under /artifacts. After a run completes, the server copies artifacts out of the sandbox into ARTIFACTS_DIR and serves them over HTTP.
From an MCP client’s point of view this is the same for local Docker, Docker-in-Docker, and the Kubernetes-native backend: clients always download via GET /artifacts/... and never talk to the sandbox filesystem directly.
GET /artifacts/<identifier>/<run_id>/<path>GET /artifacts/<identifier>/latest/<path>make docker-build-sandbox
cp .env.example .env
make dev
This starts the server on http://localhost:8080.
http://localhost:8080/mcphttp://localhost:8080/mcp/events?run_id=...Below are example configs for connecting to a running server over HTTP + SSE.
// ~/.config/opencode/config.json
{
"mcpServers": {
"mcp-sandboxd": {
"type": "sse",
"url": "http://localhost:8080/mcp"
}
}
}
Add a custom connector and point it at your running server.
http://localhost:8080/mcp (or your deployed https://.../mcp)Starts mcp-sandboxd on http://localhost:8080/mcp.
{
"mcpServers": {
"mcp-sandboxd": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-p",
"8080:8080",
"-e",
"PORT=8080",
"-e",
"MCP_PATH=/mcp",
"-e",
"SANDBOX_BACKEND=docker",
"-e",
"SANDBOX_IMAGE=ghcr.io/jeliasson/mcp-sandboxd-sandbox:latest",
"-v",
"/var/run/docker.sock:/var/run/docker.sock",
"ghcr.io/jeliasson/mcp-sandboxd:latest"
]
}
}
}
General
Backend
no-new-privileges is enabled by default; sudo won’t work inside the sandbox.run_sandbox.options.as_user="root" for administrative operations.mcp-sandboxd in a dedicated namespace with default-deny egress.MCP server for running commands in persistent, isolated sandboxes on Docker or Kubernetes
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
MCP Sandboxd 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 MCP server for running commands in persistent, isolated sandboxes on Docker or Kubernetes