# Hyperlight

> Hyperlight is an open-source MCP server for developer tools. Run Python in a local hardware-isolated micro-VM that keeps state between calls. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/hyperlight-dev/hyperlight-unikraft/tree/HEAD/integrations/mcp
- **MCP Registry name:** io.github.hyperlight-dev/mcp-server-hyperlight
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

Hyperlight boots a Unikraft unikernel in its own micro-VM on your machine, using KVM or MSHV on Linux, WHP on Windows and HVF on Apple silicon through the hluk CLI. It needs no account, daemon or API key, and the README says code and data stay local. The guest has no network unless you allow hosts with --net-allow, and sees none of your files unless you mount them.

Two tools do the work: run_python executes code with variables and imports persisting like a notebook, returning printed output and a trailing expression, and reset_sandbox swaps in a fresh guest from a warm snapshot, in about 60 ms on Linux with KVM. A call over the timeout (30 seconds by default) is stopped and the guest replaced. The image ships CPython 3.12 with numpy, pandas, scipy, scikit-learn, matplotlib, pillow and requests; the first start downloads roughly 130 MB and builds a snapshot, which can take seconds to minutes.

Limits are stated: Python and text only, one vCPU, pip installs lost after a reset unless passed with --package, and a call already running cannot be stopped before its timeout.

## Features

- **Micro-VM isolation:** Code runs in its own kernel via a hypervisor.
- **Stateful sessions:** Variables and imports persist across calls.
- **Network off by default:** Hosts must be allowed explicitly.
- **Fast reset:** Fresh guest from a warm snapshot in about 60 ms.
- **Preinstalled data stack:** numpy, pandas, scipy, scikit-learn and more.
- **Mountable files:** Directories can be mounted read-only.

## Good for

- Let an agent analyse data without touching the host
- Run untrusted generated code safely
- Prototype with pandas in a notebook-like session
- Allow only one package host for installs

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server-hyperlight -- uvx mcp-server-hyperlight
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-server-hyperlight": {
      "command": "uvx",
      "args": [
        "mcp-server-hyperlight"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server-hyperlight": {
      "command": "uvx",
      "args": [
        "mcp-server-hyperlight"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server-hyperlight": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-hyperlight"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server-hyperlight": {
      "command": "uvx",
      "args": [
        "mcp-server-hyperlight"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server-hyperlight": {
      "command": "uvx",
      "args": [
        "mcp-server-hyperlight"
      ]
    }
  }
}
```

## Tools

- `run_python`: Runs Python with state kept between calls
- `reset_sandbox`: Replaces the guest with a fresh one from a warm snapshot

## FAQ

### Does it need an account or API key?

No, it runs locally with hluk and a hypervisor.

### Can the code reach the internet?

Not unless you allow hosts with --net-allow.

### What happens on timeout?

The call is stopped and the guest replaced; the model is told its variables are gone.

### Is Hyperlight free?

Yes. Hyperlight is open source, so you can use and self-host it for free.

### How do I add Hyperlight to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-hyperlight -- uvx mcp-server-hyperlight

### What are the best alternatives to Hyperlight?

The closest alternatives to Hyperlight are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/hyperlight
