Nemeton MCP

resmi

Jembatan MCP sumber terbuka untuk Nemeton: buat, jalankan, ambil snapshot, dan kendalikan mesin virtual macOS native dari Claude Desktop, Claude Code, atau Cursor, termasuk otomasi UI di dalam guest. Berjalan secara lokal di Apple silicon.

GitHub

Apa yang bisa Anda lakukan dengan Nemeton MCP?

Buat dan konfigurasikan VM — Minta asisten Anda untuk membuat VM dengan distro, jumlah CPU, dan RAM yang dipilih, lalu perbarui atau kloning nanti.
Kendalikan status daya VM — Mulai, hentikan, jeda, lanjutkan, tangguhkan, atau hentikan paksa VM, dan periksa status penangguhan.
Jalankan perintah melalui SSH — Gunakan ssh_execute untuk menjalankan perintah di dalam VM dan vm_ip untuk menemukan alamatnya.
Transfer file — Unggah, unduh, dan daftar file di dalam VM dengan file_upload, file_download, dan file_list.
Kelola snapshot — Buat, daftar, pulihkan, dan hapus snapshot CoW dari sebuah VM.
Baca konsol dan tangkapan layar — Kirim input konsol, baca output, jalankan perintah konsol, dan ambil tangkapan layar.

Dokumentasi

Server MCP Nemeton

Kendalikan mesin virtual macOS native dari Claude Desktop, Claude Code, Cursor, atau klien MCP apa pun.

Ini adalah jembatan resmi Model Context Protocol untuk Nemeton — aplikasi macOS native yang membuat dan mengelola VM Linux dan macOS menggunakan Virtualization.framework dari Apple (tanpa Parallels, tanpa VMware, tanpa langganan).

Anda perlu menginstal dan menjalankan aplikasi Nemeton. Server MCP ini adalah jembatan stdio→HTTP yang tipis — logika VM yang sebenarnya berada di dalam aplikasi. Dapatkan Nemeton di store.juergenkoller.software/apps/nemeton.

Yang dapat Anda lakukan

"Claude, nyalakan VM Ubuntu 24.04 dengan 4 CPU dan RAM 8 GB, pasang Docker, dan beri tahu saya saat sudah siap."

Server MCP ini menyediakan 50+ alat dalam kategori berikut:

Kategori	Alat
Siklus Hidup VM	`list_vms`, `get_vm`, `create_vm`, `update_vm`, `clone_vm`, `delete_vm`, `reorder_vms`, `stop_all`
Kontrol VM	`start_vm`, `stop_vm`, `force_stop_vm`, `pause_vm`, `resume_vm`, `suspend_vm`, `get_suspend_status`
Snapshot (CoW pada APFS)	`list_snapshots`, `create_snapshot`, `restore_snapshot`, `delete_snapshot`
Konsol	`send_console`, `read_console`, `console_execute`, `take_screenshot`
Jaringan & Berkas	`vm_ip`, `ssh_execute`, `file_upload`, `file_download`, `file_list`
Kontrol GUI	`gui_launch`, `gui_windows`, `vscode_command`, `select_vm`
Jembatan Papan Klip	`clipboard_read`, `clipboard_write`
Info Host	`get_host_info`, `get_metrics`
Penyimpanan	`resize_disk`, `export_vm`, `import_vm`
Distro	`list_distros` (Ubuntu, Debian, Fedora, Arch — unduh ISO otomatis)
Tampilan	`fullscreen_enter`, `fullscreen_exit`, `fullscreen_toggle`
Webhook	`list_webhooks`, `register_webhook`, `delete_webhook`
Runtime	`vm_runtime`, `vm_errors`, `list_downloads`

Setiap alat mengembalikan JSON terstruktur dengan status VM, metadata snapshot, keluaran konsol, atau hasil operasi.

Instalasi

Prasyarat

macOS 14 (Sonoma) atau lebih baru — diperlukan untuk fitur Virtualization.framework.
Aplikasi Nemeton terinstal dan berjalan — dapatkan di sini.
Swift 5.9+ (Xcode 15+) jika Anda ingin membangun dari sumber. Biner siap pakai juga tersedia.

Bangun dari sumber

git clone https://github.com/juergenkoller-software/nemeton-mcp.git
cd nemeton-mcp
swift build -c release
# Binary: .build/release/NemetonMCP

Biner siap pakai

Unduh biner NemetonMCP terbaru dari halaman Releases.

Konfigurasi

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nemeton": {
      "command": "/path/to/NemetonMCP",
      "env": {
        "NEMETON_PORT": "22100",
        "NEMETON_TOKEN": "your-token-here"
      }
    }
  }
}

Dapatkan NEMETON_TOKEN dari Nemeton → Settings → API & Integrations.

Claude Code

Tambahkan ke ~/.claude/mcp.json (atau melalui claude mcp add):

claude mcp add nemeton /path/to/NemetonMCP \
  --env NEMETON_PORT=22100 \
  --env NEMETON_TOKEN=your-token-here

Cursor / klien MCP lainnya

Pola yang sama: konfigurasikan NemetonMCP sebagai server MCP stdio dengan dua variabel lingkungan di atas.

Cara kerjanya

┌────────────────┐  JSON-RPC stdio   ┌────────────────┐  HTTP+Bearer   ┌────────────────┐
│  Claude/Cursor │ ───────────────►  │  NemetonMCP    │ ─────────────► │  Nemeton.app   │
│  (MCP client)  │ ◄───────────────  │   (this repo)  │ ◄───────────── │  (port 22100)  │
└────────────────┘                   └────────────────┘                └────────────────┘

Jembatan ini membaca permintaan JSON-RPC 2.0 dari stdin, meneruskannya ke server HTTP lokal Nemeton di 127.0.0.1:22100/mcp, dan menulis respons kembali ke stdout. Semua autentikasi, logika VM, dan pengiriman alat terjadi di dalam aplikasi Nemeton.

Pemisahan ini memungkinkan kami menjaga format wire MCP tetap open-source (sehingga Anda dapat mengauditnya, mem-fork-nya, atau menjalankannya melalui lapisan sandbox apa pun yang Anda sukai) sementara internal VM tetap berada di dalam aplikasi.

Variabel lingkungan

Variabel	Default	Deskripsi
`NEMETON_PORT`	`22100`	Port server HTTP lokal Nemeton
`NEMETON_TOKEN`	(tidak ada)	Token bearer dari Pengaturan Nemeton (diperlukan untuk operasi tulis)

Kesalahan dan log jejak ditulis ke stderr agar tidak mengotori saluran stdout JSON-RPC.

Tentang Nemeton

Nemeton adalah aplikasi macOS native untuk membuat dan mengelola mesin virtual menggunakan Virtualization.framework dari Apple. Sorotan:

Tanpa langganan — pembelian sekali, €389
VM Linux & macOS dengan unduhan ISO/IPSW otomatis
Snapshot CoW pada APFS — simpan status VM tanpa membuang ruang disk
REST API + peristiwa WebSocket (42 endpoint) untuk otomatisasi
Server MCP (repo ini) untuk Claude/agen AI
Performa native — menggunakan framework Apple secara langsung, tanpa overhead QEMU
100% lokal — tanpa cloud, tanpa telemetri

→ Dapatkan Nemeton di store.juergenkoller.software

Lisensi

MIT — lihat LICENSE. Jembatan ini open source; aplikasi Nemeton sendiri bersifat komersial.

Masalah & dukungan

Bug jembatan: buka issue
Dukungan aplikasi: support@juergenkoller.software

Dibuat oleh Juergen Koller Software GmbH.