Skip to main content
Glama
superradcompany

microsandbox-mcp

by superradcompany
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

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

License

Apache-2.0

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/superradcompany/microsandbox-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server