juergenkoller-software/nemeton-mcp

**Control native macOS virtual machines from Claude Desktop, Claude Code, Cursor, or any MCP client.**
This is the official Model Context Protocol bridge for **Nemeton** — a native macOS app that creates and manages Linux and macOS VMs using Apple's Virtualization.framework (no Parallels, no VMware, no subscriptions).
> **You need the Nemeton app installed and running.** This MCP server is a thin stdio→HTTP bridge — the actual VM logic lives in the app. Get Nemeton at store.juergenkoller.software/apps/nemeton.
---
What you can do
> "Claude, spin up an Ubuntu 24.04 VM with 4 CPUs and 8 GB RAM, install Docker, and tell me when it's ready."
The MCP server exposes **50+ tools** across these categories:
| Category | Tools |
|---|---|
| **VM Lifecycle** | list_vms, get_vm, create_vm, update_vm, clone_vm, delete_vm, reorder_vms, stop_all |
| **VM Control** | start_vm, stop_vm, force_stop_vm, pause_vm, resume_vm, suspend_vm, get_suspend_status |
| **Snapshots** (CoW on APFS) | list_snapshots, create_snapshot, restore_snapshot, delete_snapshot |
| **Console** | send_console, read_console, console_execute, take_screenshot |
| **Networking & Files** | vm_ip, ssh_execute, file_upload, file_download, file_list |
| **GUI Control** | gui_launch, gui_windows, vscode_command, select_vm |
| **Clipboard Bridge** | clipboard_read, clipboard_write |
| **Host Info** | get_host_info, get_metrics |
| **Storage** | resize_disk, export_vm, import_vm |
| **Distros** | list_distros (Ubuntu, Debian, Fedora, Arch — auto-download ISOs) |
| **Display** | fullscreen_enter, fullscreen_exit, fullscreen_toggle |
| **Webhooks** | list_webhooks, register_webhook, delete_webhook |
| **Runtime** | vm_runtime, vm_errors, list_downloads |
Each tool returns structured JSON with VM state, snapshot metadata, console output, or operation result.
---
Installation
Prerequisites
1. **macOS 14 (Sonoma) or later** — required for Virtualization.framework features.
2. **Nemeton app installed and running** — get it here.
3. **Swift 5.9+** (Xcode 15+) if you want to build from source. Pre-built binaries are also available.
Build from source
Pre-built binary
Download the latest NemetonMCP binary from the Releases page.
---
Configuration
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
Get NEMETON_TOKEN from **Nemeton → Settings → API & Integrations**.
Claude Code
Add to ~/.claude/mcp.json (or via claude mcp add):
Cursor / other MCP clients
Same pattern: configure NemetonMCP as a stdio MCP server with the two environment variables above.
---
How it works
The bridge reads JSON-RPC 2.0 requests from stdin, forwards them to Nemeton's local HTTP server at 127.0.0.1:22100/mcp, and writes responses back to stdout. All authentication, VM logic, and tool dispatch happens inside the Nemeton app.
This split lets us keep the MCP wire format open-source (so you can audit it, fork it, or run it through any sandboxing layer you prefer) while the VM internals stay in the app.