Nemeton MCP

resmi

Nemeton için açık kaynaklı MCP köprüsü: Claude Desktop, Claude Code veya Cursor üzerinden yerel macOS sanal makineleri oluşturun, başlatın, anlık görüntü alın ve kontrol edin; konuk işletim sistemi içinde UI otomasyonu dahil. Apple silicon üzerinde yerel olarak çalışır.

GitHub

Nemeton MCP ile neler yapabilirsiniz?

VM'leri oluşturun ve yapılandırın — Asistanınızdan seçilen bir dağıtım, CPU sayısı ve RAM ile bir VM oluşturmasını isteyin, ardından daha sonra güncelleyin veya klonlayın.
VM güç durumunu kontrol edin — VM'leri başlatın, durdurun, duraklatın, devam ettirin, askıya alın veya zorla durdurun ve askıya alma durumunu kontrol edin.
SSH üzerinden komut çalıştırın — Bir VM içinde komut çalıştırmak için ssh_execute ve adresini bulmak için vm_ip kullanın.
Dosya aktarın — file_upload, file_download ve file_list ile bir VM içindeki dosyaları yükleyin, indirin ve listeleyin.
Anlık görüntüleri yönetin — Bir VM'nin CoW anlık görüntülerini oluşturun, listeleyin, geri yükleyin ve silin.
Konsolu ve ekran görüntülerini okuyun — Konsol girişi gönderin, çıktıyı okuyun, konsol komutlarını çalıştırın ve ekran görüntüleri alın.

Dokümantasyon

Nemeton MCP Sunucusu

Yerel macOS sanal makinelerini Claude Desktop, Claude Code, Cursor veya herhangi bir MCP istemcisinden yönetin.

Bu, Nemeton için resmi Model Context Protocol köprüsüdür — Apple'ın Virtualization.framework teknolojisini kullanarak Linux ve macOS VM'leri oluşturan ve yöneten yerel bir macOS uygulaması (Parallels yok, VMware yok, abonelik yok).

Nemeton uygulamasının kurulu ve çalışıyor olması gerekir. Bu MCP sunucusu ince bir stdio→HTTP köprüsüdür — asıl VM mantığı uygulamanın içinde yer alır. Nemeton'u store.juergenkoller.software/apps/nemeton adresinden edinin.

Neler yapabilirsiniz

"Claude, 4 CPU ve 8 GB RAM ile bir Ubuntu 24.04 VM'i başlat, Docker'ı kur ve hazır olduğunda bana söyle."

MCP sunucusu şu kategorilerde 50'den fazla araç sunar:

Kategori	Araçlar
VM Yaşam Döngüsü	`list_vms`, `get_vm`, `create_vm`, `update_vm`, `clone_vm`, `delete_vm`, `reorder_vms`, `stop_all`
VM Kontrolü	`start_vm`, `stop_vm`, `force_stop_vm`, `pause_vm`, `resume_vm`, `suspend_vm`, `get_suspend_status`
Anlık Görüntüler (APFS üzerinde CoW)	`list_snapshots`, `create_snapshot`, `restore_snapshot`, `delete_snapshot`
Konsol	`send_console`, `read_console`, `console_execute`, `take_screenshot`
Ağ ve Dosyalar	`vm_ip`, `ssh_execute`, `file_upload`, `file_download`, `file_list`
GUI Kontrolü	`gui_launch`, `gui_windows`, `vscode_command`, `select_vm`
Pano Köprüsü	`clipboard_read`, `clipboard_write`
Ana Bilgisayar Bilgisi	`get_host_info`, `get_metrics`
Depolama	`resize_disk`, `export_vm`, `import_vm`
Dağıtımlar	`list_distros` (Ubuntu, Debian, Fedora, Arch — ISO'ları otomatik indirir)
Ekran	`fullscreen_enter`, `fullscreen_exit`, `fullscreen_toggle`
Web Kancaları	`list_webhooks`, `register_webhook`, `delete_webhook`
Çalışma Zamanı	`vm_runtime`, `vm_errors`, `list_downloads`

Her araç, VM durumu, anlık görüntü meta verileri, konsol çıktısı veya işlem sonucu içeren yapılandırılmış JSON döndürür.

Kurulum

Ön koşullar

macOS 14 (Sonoma) veya üzeri — Virtualization.framework özellikleri için gereklidir.
Nemeton uygulaması kurulu ve çalışıyor olmalı — buradan edinin.
Swift 5.9+ (Xcode 15+) — kaynaktan derlemek istiyorsanız. Önceden derlenmiş ikili dosyalar da mevcuttur.

Kaynaktan derleme

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

Önceden derlenmiş ikili dosya

En son NemetonMCP ikili dosyasını Sürümler sayfasından indirin.

Yapılandırma

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json dosyasını düzenleyin:

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

NEMETON_TOKEN değerini Nemeton → Ayarlar → API ve Entegrasyonlar bölümünden alın.

Claude Code

~/.claude/mcp.json dosyasına ekleyin (veya claude mcp add aracılığıyla):

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

Cursor / diğer MCP istemcileri

Aynı yöntem: NemetonMCP dosyasını, yukarıdaki iki ortam değişkeniyle birlikte bir stdio MCP sunucusu olarak yapılandırın.

Nasıl çalışır

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

Köprü, stdin üzerinden JSON-RPC 2.0 isteklerini okur, bunları Nemeton'un 127.0.0.1:22100/mcp adresindeki yerel HTTP sunucusuna iletir ve yanıtları stdout üzerine geri yazar. Tüm kimlik doğrulama, VM mantığı ve araç yönlendirmesi Nemeton uygulamasının içinde gerçekleşir.

Bu ayrım sayesinde MCP iletişim biçimini açık kaynak olarak tutabiliyoruz (böylece denetleyebilir, çatallayabilir veya tercih ettiğiniz herhangi bir korumalı alan katmanı üzerinden çalıştırabilirsiniz), VM iç işleyişi ise uygulamanın içinde kalır.

Ortam değişkenleri

Değişken	Varsayılan	Açıklama
`NEMETON_PORT`	`22100`	Nemeton'un yerel HTTP sunucusunun bağlantı noktası
`NEMETON_TOKEN`	(yok)	Nemeton Ayarları'ndan alınan Bearer belirteci (yazma işlemleri için gereklidir)

Hatalar ve izleme günlükleri, JSON-RPC stdout kanalını kirletmemeleri için stderr dosyasına yazılır.

Nemeton hakkında

Nemeton, Apple'ın Virtualization.framework teknolojisini kullanarak sanal makineler oluşturan ve yöneten yerel bir macOS uygulamasıdır. Öne çıkanlar:

Abonelik yok — tek seferlik satın alma, 389 €
Linux ve macOS VM'leri — otomatik ISO/IPSW indirme ile
APFS üzerinde CoW anlık görüntüleri — disk israfı olmadan VM durumlarını kaydedin
REST API + WebSocket olayları (42 uç nokta) — otomasyon için
MCP sunucusu (bu depo) — Claude/AI ajanları için
Yerel performans — Apple'ın çerçevesini doğrudan kullanır, QEMU yükü yok
%100 yerel — bulut yok, telemetri yok

→ Nemeton'u store.juergenkoller.software adresinden edinin

Lisans

MIT — bkz. LICENSE. Köprü açık kaynaktır; Nemeton uygulamasının kendisi ticaridir.

Sorunlar ve destek

Köprü hataları: sorun bildirin
Uygulama desteği: support@juergenkoller.software

Juergen Koller Software GmbH tarafından geliştirilmiştir.