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 mcp add --transport stdio microsandbox -- npx -y microsandbox-mcp

Add to ~/.cursor/mcp.json:

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

Add to .vscode/mcp.json:

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

Add to your config file:

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

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

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

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

Add to your Zed settings:

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

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