sandbox MCP server
2026년 11월 14일 커밋cocoon guest stack을 사용하여 AI agent를 위한 빠른 부팅 MicroVM 샌드박스를 제공합니다.
다른 이름 cocoonstack/sandbox
- 스타
- 89
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- AGPL-3.0
sandbox MCP란?
cocoon guest stack을 사용하여 AI agent를 위한 빠른 부팅 MicroVM 샌드박스를 제공합니다.
프로젝트 README에서 생성된 요약
sandbox MCP server 정보
이 MCP server는 cocoon guest stack을 통해 AI agent를 위한 빠른 부팅 MicroVM 샌드박스를 제공합니다. 개발자는 웜 풀(warm pools)을 사용하여 1밀리초 미만의 시간 내에 확보할 수 있는 격리된 실행 환경을 생성할 수 있습니다. 풀 미스(pool miss)가 발생하면 시스템은 수십 밀리초 내에 골든 스냅샷(golden snapshot)으로부터 클론을 생성하며, 베어 메탈에서의 콜드 부팅은 약 0.2에서 0.4초가 소요됩니다.
이 server를 사용하려면 KVM, Cloud Hypervisor, jq가 설치된 Linux 노드에서 sandboxd를 실행해야 합니다. 설정 시 리슨 주소(listen address), API token, 풀 템플릿을 지정하는 설정 파일이 필요합니다. 컨트롤 플레인이 실행되면 AI agent는 Go 또는 Python SDK, 또는 전용 MCP stdio server를 통해 이러한 환경과 상호작용할 수 있습니다. 이 아키텍처는 에이전트 워크플로우에서 신속한 환경 프로비저닝이 필수적인 고성능 워크로드를 위해 설계되었습니다.
활용 사례
- 1신속한 실행 환경 프로비저닝AI agent는 웜 클레임(warm claims)을 사용하여 1밀리초 미만의 지연 시간으로 신뢰할 수 없는 코드를 실행하기 위한 새로운 샌드박스 인스턴스를 요청할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능cocoonstack/sandbox is public and reachablegithub.com/cocoonstack/sandbox ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-14github.com/cocoonstack/sandbox ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기sandbox
MicroVM sandboxes for AI agents, built on cocoon: a fast-boot guest stack, an in-guest product daemon, a per-node control plane with warm pools, and SDKs for Go and Python. Warm claims are sub-millisecond; a pool miss clones from a golden snapshot in tens of milliseconds; cold boot is ~0.2–0.4 s on bare metal.
Documentation: cocoonstack.github.io/sandbox
(source in docs/); the architecture overview is in
docs/index.md.
Quick start
On a Linux node with KVM, cocoon v0.6.9
or newer, Cloud Hypervisor and jq, as root, from a checkout with Go installed.
Not on a node that already runs sandboxd on the same cocoon root: at start
sandboxd removes every sbx- VM it does not own.
make sandboxd
cocoon image pull ghcr.io/cocoonstack/sandbox/rt:24.04
cat >config.json <<'EOF'
{
"listen": "127.0.0.1:7777",
"api_token": "change-me",
"pools": [
{"template": "ghcr.io/cocoonstack/sandbox/rt:24.04", "net": "none", "size": "small", "warm": 2}
]
}
EOF
dist/sandboxd -config config.json &
# Wait for the golden snapshot and the warm pool.
until curl -sf -H 'Authorization: Bearer change-me' http://127.0.0.1:7777/v1/info |
jq -e '(.pools | length) > 0 and all(.pools[]; .golden and .warm >= .target)' >/dev/null; do sleep 1; done
# Claim, exec and release three times; prints each latency.
(cd e2e && GOWORK=off go run ./cmd/demo -addr 127.0.0.1:7777 -token change-me \
-template ghcr.io/cocoonstack/sandbox/rt:24.04)
A stopped sandboxd leaves its VMs for the next start. To remove them:
kill %1
cocoon vm list --format json | jq -r '.[].config.name | select(startswith("sbx-"))' |
while read -r vm; do cocoon vm stop --force "$vm"; cocoon vm rm --force "$vm"; done
demo is a small program over the Go SDK; the
Python SDK has the same calls. Deploying
sandboxd covers release binaries, the full config and systemd.
Related projects
- cocoon — the microVM engine underneath
- vk-sandbox — the Kubernetes provider that claims from sandboxd
- sandbox-operator — the Kubernetes apiserver and e2b-compatible data plane over warm pools
Layout
silkd/— in-guest product daemon (Rust), baked into the base image; newline-JSON frames over vsock 2048 (reference)sandboxd/— per-node control plane (Go): warm pools, the claim API and the relays to silkd (deploy, API)sdk/go/— Go SDK;sdk/go/silkd/is its connection layer andsdk/go/silkd/silkdtest/a test fakesdk/python/— Python SDK, stdlib-only and synchronousmcp/—sandbox-mcp, an MCP stdio serversdk/openai/—cocoonstack-sandbox-openai, a sandbox provider for the OpenAI Agents SDKsdk/langchain/—cocoonstack-sandbox-langchain, a LangChain toolkitprotocol/wire/— the frame vocabulary andfixtures/, the golden corpus the Rust, Go and Python tests check, so wire drift fails CIe2e/— in-process full-stack tests (real pool/engine/relay/SDK, fake cocoon + guest) and the bare-metal driversboot/kernel/— kernel version pin (VERSION+ matching tarballSHA256, bump both together) and config fragmentsboot/init/—sandbox-init, the entire initramfs userland (static Rust)boot/Dockerfile— multi-stage: kernel → init → cpio → scratch image with/boot/vmlinuz-sandbox+/boot/initrd.img-sandboxos-image/— VM images consuming the boot artifact:base,rt,python,python-rt,node,node-rt,browser,android,e2b-rt,e2b-ciscripts/— benchmarks and bare-metal e2e, see Verifying a nodepackaging/— the systemd unit deploy installs
CI
silkd.yml/sandboxd.yml— Rust and Go test+lint suitesboot-init.yml— the boot/init crate's own fmt+clippy+test gatepython.yml— ruff + pytest for the three Python packages, mypy for the base SDKshell.yml— shellcheck over every tracked shell scriptimages.yml— the single image entry point: on a push touchingboot/**,silkd/**, oros-image/**it builds the changed carriers (viabuild-boot.yml/build-silkd.yml,workflow_call) then os-images, in order, so the chain is deterministicbuild-os-images.yml— bakes base + flavors FROM the carriers, sha-pinned when rebuilt in the same runrelease.yml— on a version tag, checks the tag against silkd's version, then builds the release binaries and archivespublish-pypi.yml— on ansdk-*-v*tag, builds and publishes the matching package via PyPI Trusted Publishing (OIDC, per-package environment)
Boot chain
cloud-hypervisor
→ guest kernel (amd64: PVH ELF vmlinux, everything =y, no decompress stage; arm64: flat Image)
→ uncompressed ~1.5MB cpio: /init = sandbox-init (static Rust)
→ resolve virtio-blk serials via sysfs (2ms poll, no udev)
→ mount EROFS layers → overlayfs + ext4 COW → switch_root
→ exec /sbin/init (systemd, trimmed; cocoon-agent + silkd start at sysinit)
The cmdline keys sandbox-init consumes are in the
boot contract.
Development
make help # every target; the ones below are the daily set
make lint test # Rust: boot/init + silkd (fmt --check, clippy -D warnings, tests)
make go-lint # Go: protocol/wire + sandboxd + sdk/go + e2e + mcp, GOOS linux AND darwin
make go-test # Go: go test -race plus one pass of every benchmark, across the Go modules
make sh-lint # shellcheck every tracked shell script
make sandboxd # build dist/sandboxd
make bench # claim-tier + data-plane benchmarks; removes every sbx-* VM
make boot # kernel + initramfs artifact image (docker)
make silkd-image # silkd release binary in a scratch carrier image
make images # base + python images against the local boot + silkd images
License
The server stack — sandboxd, silkd, the boot chain, the OS images, and the
MCP server — is a product, and is licensed under AGPL-3.0. The client SDKs
(sdk/go, sdk/python, sdk/openai, sdk/langchain) and the
protocol/wire module the Go SDK requires are licensed under Apache-2.0
(see the LICENSE file in each directory) and carry no copyleft obligation.
sandbox MCP 질문
샌드박스 부팅 속도는 얼마나 빠른가요?
베어 메탈에서 콜드 부팅은 약 0.2~0.4초가 소요되며, 웜 부팅은 1밀리초 미만입니다.
SDK에서 지원하는 언어는 무엇인가요?
샌드박스는 Go와 Python SDK를 모두 제공합니다.
이미 VM이 존재하는 노드에서 sandboxd를 시작하면 어떻게 되나요?
시작 시 sandboxd는 자신이 소유하지 않은 'sbx-'로 시작하는 모든 VM을 삭제합니다.