microsandbox-mcp

Give your AI agents sandboxes. This MCP server connects any AI agent to microsandbox — letting them create fast lightweight sandboxes, execute code, manage files, and monitor resources.

Documentation | npm Package | GitHub

Installation

Run the server with npx -y microsandbox-mcp using stdio transport.

Claude Code

claude mcp add --transport stdio microsandbox -- npx -y microsandbox-mcp

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "microsandbox": {
      "command": "npx",
      "args": ["-y", "microsandbox-mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "microsandbox": {
      "command": "npx",
      "args": ["-y", "microsandbox-mcp"]
    }
  }
}

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "microsandbox": {
      "command": "npx",
      "args": ["-y", "microsandbox-mcp"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "microsandbox": {
      "command": "npx",
      "args": ["-y", "microsandbox-mcp"]
    }
  }
}

Zed

Add to your Zed settings:

{
  "context_servers": {
    "microsandbox": {
      "command": {
        "path": "npx",
        "args": ["-y", "microsandbox-mcp"]
      }
    }
  }
}

Other Clients

For any MCP client that supports stdio transport:

{
  "mcpServers": {
    "microsandbox": {
      "command": "npx",
      "args": ["-y", "microsandbox-mcp"]
    }
  }
}

Available Tools

Sandbox Lifecycle:

Tool	Description
sandbox_run	Create an ephemeral sandbox, run a command, return the output, and destroy it
sandbox_create	Create and boot a persistent named sandbox with full configuration
sandbox_list	List all sandboxes with their current status
sandbox_inspect	Get detailed sandbox information including full configuration
sandbox_stop	Stop a running sandbox (graceful SIGTERM or force SIGKILL)
sandbox_remove	Remove a stopped sandbox

Command Execution:

Tool	Description
sandbox_exec	Execute a command with arguments inside a running sandbox
sandbox_shell	Execute a shell command string with pipes, redirects, and shell syntax

Filesystem:

Tool	Description
sandbox_fs_read	Read a file from the sandbox filesystem
sandbox_fs_write	Write content to a file inside the sandbox
sandbox_fs_list	List directory contents
sandbox_fs_mkdir	Create a directory with parent directories
sandbox_fs_remove	Remove a file or directory
sandbox_fs_stat	Get file metadata (kind, size, mode, modified time)

Volume Management:

Tool	Description
volume_create	Create a named persistent volume that survives sandbox restarts
volume_list	List all volumes
volume_remove	Remove a named volume

Monitoring:

Tool	Description
sandbox_metrics	Get live CPU, memory, disk I/O, and network metrics
check_installed	Verify that the msb runtime and libkrunfw are available

Requirements

macOS (Apple Silicon) or Linux (x86_64/ARM64 with KVM support).

The msb runtime and libkrunfw are installed automatically on first run. If that fails, install manually:

curl -fsSL https://install.microsandbox.dev | sh

Development

git clone https://github.com/superradcompany/microsandbox-mcp.git
cd microsandbox-mcp
npm install
npm run build
node dist/index.js

Links

• microsandbox — The microVM sandbox runtime
• Documentation — Guides and API reference
• Agent Skills — Teach agents to use microsandbox without MCP

License

Apache-2.0