Nemeton MCP

officiel

Passerelle MCP open source pour Nemeton : créez, démarrez, prenez des instantanés et contrôlez des machines virtuelles macOS natives depuis Claude Desktop, Claude Code ou Cursor, y compris l'automatisation de l'interface utilisateur dans l'invité. S'exécute localement sur Apple silicon.

GitHub

Que pouvez-vous faire avec Nemeton MCP ?

Créer et configurer des VM — Demandez à votre assistant de créer une VM avec une distribution, un nombre de CPU et une RAM choisis, puis de la mettre à jour ou de la cloner ultérieurement.
Contrôler l'état d'alimentation des VM — Démarrez, arrêtez, mettez en pause, reprenez, suspendez ou forcez l'arrêt des VM, et vérifiez l'état de suspension.
Exécuter des commandes via SSH — Utilisez ssh_execute pour exécuter des commandes dans une VM et vm_ip pour trouver son adresse.
Transférer des fichiers — Téléversez, téléchargez et listez des fichiers dans une VM avec file_upload, file_download et file_list.
Gérer les instantanés — Créez, listez, restaurez et supprimez des instantanés CoW d'une VM.
Lire la console et les captures d'écran — Envoyez des entrées à la console, lisez la sortie, exécutez des commandes de console et capturez des captures d'écran.

Documentation

Serveur MCP Nemeton

Contrôlez des machines virtuelles macOS natives depuis Claude Desktop, Claude Code, Cursor ou tout client MCP.

Il s'agit du pont officiel Model Context Protocol pour Nemeton — une application macOS native qui crée et gère des VM Linux et macOS à l'aide du framework Virtualization.framework d'Apple (sans Parallels, sans VMware, sans abonnement).

L'application Nemeton doit être installée et en cours d'exécution. Ce serveur MCP est un simple pont stdio→HTTP — la logique réelle des VM réside dans l'application. Obtenez Nemeton sur store.juergenkoller.software/apps/nemeton.

Ce que vous pouvez faire

« Claude, crée une VM Ubuntu 24.04 avec 4 CPU et 8 Go de RAM, installe Docker et préviens-moi quand c'est prêt. »

Le serveur MCP expose plus de 50 outils répartis dans ces catégories :

Catégorie	Outils
Cycle de vie des VM	`list_vms`, `get_vm`, `create_vm`, `update_vm`, `clone_vm`, `delete_vm`, `reorder_vms`, `stop_all`
Contrôle des VM	`start_vm`, `stop_vm`, `force_stop_vm`, `pause_vm`, `resume_vm`, `suspend_vm`, `get_suspend_status`
Instantanés (CoW sur APFS)	`list_snapshots`, `create_snapshot`, `restore_snapshot`, `delete_snapshot`
Console	`send_console`, `read_console`, `console_execute`, `take_screenshot`
Réseau et fichiers	`vm_ip`, `ssh_execute`, `file_upload`, `file_download`, `file_list`
Contrôle de l'interface graphique	`gui_launch`, `gui_windows`, `vscode_command`, `select_vm`
Pont presse-papiers	`clipboard_read`, `clipboard_write`
Informations sur l'hôte	`get_host_info`, `get_metrics`
Stockage	`resize_disk`, `export_vm`, `import_vm`
Distributions	`list_distros` (Ubuntu, Debian, Fedora, Arch — téléchargement automatique des ISO)
Affichage	`fullscreen_enter`, `fullscreen_exit`, `fullscreen_toggle`
Webhooks	`list_webhooks`, `register_webhook`, `delete_webhook`
Exécution	`vm_runtime`, `vm_errors`, `list_downloads`

Chaque outil renvoie un JSON structuré contenant l'état de la VM, les métadonnées d'instantané, la sortie de la console ou le résultat de l'opération.

Installation

Prérequis

macOS 14 (Sonoma) ou version ultérieure — requis pour les fonctionnalités de Virtualization.framework.
Application Nemeton installée et en cours d'exécution — obtenez-la ici.
Swift 5.9+ (Xcode 15+) si vous souhaitez compiler depuis les sources. Des binaires précompilés sont également disponibles.

Compiler depuis les sources

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

Binaire précompilé

Téléchargez le dernier binaire NemetonMCP depuis la page des versions.

Configuration

Claude Desktop

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

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

Obtenez NEMETON_TOKEN dans Nemeton → Réglages → API et intégrations.

Claude Code

Ajoutez à ~/.claude/mcp.json (ou via claude mcp add) :

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

Cursor / autres clients MCP

Même principe : configurez NemetonMCP comme serveur MCP stdio avec les deux variables d'environnement ci-dessus.

Fonctionnement

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

Le pont lit les requêtes JSON-RPC 2.0 depuis stdin, les transmet au serveur HTTP local de Nemeton à l'adresse 127.0.0.1:22100/mcp, puis renvoie les réponses sur stdout. Toute l'authentification, la logique des VM et la répartition des outils s'effectuent à l'intérieur de l'application Nemeton.

Cette séparation nous permet de garder le format de communication MCP open source (afin que vous puissiez l'auditer, le forker ou l'exécuter dans la couche de sandboxing de votre choix) tandis que les mécanismes internes des VM restent dans l'application.

Variables d'environnement

Variable	Valeur par défaut	Description
`NEMETON_PORT`	`22100`	Port du serveur HTTP local de Nemeton
`NEMETON_TOKEN`	(aucune)	Jeton Bearer issu des réglages de Nemeton (requis pour les opérations d'écriture)

Les erreurs et les journaux de trace sont écrits dans stderr afin de ne pas polluer le canal stdout JSON-RPC.

À propos de Nemeton

Nemeton est une application macOS native permettant de créer et de gérer des machines virtuelles à l'aide du framework Virtualization.framework d'Apple. Points forts :

Sans abonnement — achat unique, 389 €
VM Linux et macOS avec téléchargement automatique des ISO/IPSW
Instantanés CoW sur APFS — enregistrez l'état des VM sans gaspiller d'espace disque
API REST + événements WebSocket (42 points de terminaison) pour l'automatisation
Serveur MCP (ce dépôt) pour Claude et les agents IA
Performances natives — utilise directement le framework d'Apple, sans surcoût QEMU
100 % local — pas de cloud, pas de télémétrie

→ Obtenez Nemeton sur store.juergenkoller.software

Licence

MIT — voir LICENSE. Le pont est open source ; l'application Nemeton elle-même est commerciale.

Problèmes et support

Bogues du pont : ouvrir un ticket
Support de l'application : support@juergenkoller.software

Développé par Juergen Koller Software GmbH.