Nemeton MCP

公式

Nemeton向けのオープンソースMCPブリッジ: Claude Desktop、Claude Code、CursorからネイティブmacOS仮想マシンの作成、起動、スナップショット、制御が可能で、ゲスト内のUI自動化にも対応。Appleシリコン上でローカルに動作。

Nemeton MCPで何ができますか?

  • VM の作成と構成 — 選択したディストリビューション、CPU 数、RAM を指定して VM の作成をアシスタントに依頼し、後から更新やクローンを行えます。
  • VM の電源状態の制御 — VM の起動、停止、一時停止、再開、サスペンド、強制停止を行い、サスペンド状態を確認できます。
  • SSH 経由でのコマンド実行 — ssh_execute を使用して VM 内でコマンドを実行し、vm_ip でそのアドレスを確認できます。
  • ファイル転送 — file_upload、file_download、file_list を使用して、VM 内でファイルのアップロード、ダウンロード、一覧表示を行えます。
  • スナップショットの管理 — VM の CoW スナップショットの作成、一覧表示、復元、削除を行えます。
  • コンソールとスクリーンショットの読み取り — コンソール入力の送信、出力の読み取り、コンソールコマンドの実行、スクリーンショットのキャプチャを行えます。

ドキュメント

Nemeton MCP サーバー

Swift Platform License MCP juergenkoller-software/nemeton-mcp MCP server

Claude Desktop、Claude Code、Cursor、または任意の MCP クライアントから、ネイティブな macOS 仮想マシンを操作できます。

これは Nemeton の公式 Model Context Protocol ブリッジです。Nemeton は Apple の Virtualization.framework を使用して Linux および macOS の VM を作成・管理するネイティブ macOS アプリです(Parallels も VMware もサブスクリプションも不要)。

Nemeton アプリがインストールされ、実行されている必要があります。 この MCP サーバーは stdio→HTTP の薄いブリッジであり、実際の VM ロジックはアプリ内にあります。Nemeton は store.juergenkoller.software/apps/nemeton から入手できます。


できること

「Claude、4 CPU・8 GB RAM の Ubuntu 24.04 VM を立ち上げて、Docker をインストールして、準備できたら教えて。」

MCP サーバーは、以下のカテゴリにわたる 50 以上のツールを公開しています。

カテゴリツール
VM ライフサイクルlist_vms, get_vm, create_vm, update_vm, clone_vm, delete_vm, reorder_vms, stop_all
VM 制御start_vm, stop_vm, force_stop_vm, pause_vm, resume_vm, suspend_vm, get_suspend_status
スナップショット(APFS 上の CoW)list_snapshots, create_snapshot, restore_snapshot, delete_snapshot
コンソールsend_console, read_console, console_execute, take_screenshot
ネットワークとファイルvm_ip, ssh_execute, file_upload, file_download, file_list
GUI 制御gui_launch, gui_windows, vscode_command, select_vm
クリップボードブリッジclipboard_read, clipboard_write
ホスト情報get_host_info, get_metrics
ストレージresize_disk, export_vm, import_vm
ディストリビューションlist_distros(Ubuntu、Debian、Fedora、Arch — ISO を自動ダウンロード)
ディスプレイfullscreen_enter, fullscreen_exit, fullscreen_toggle
Webhooklist_webhooks, register_webhook, delete_webhook
ランタイムvm_runtime, vm_errors, list_downloads

各ツールは、VM の状態、スナップショットのメタデータ、コンソール出力、または操作結果を含む構造化 JSON を返します。


インストール

前提条件

  1. macOS 14(Sonoma)以降 — Virtualization.framework の機能に必要です。
  2. Nemeton アプリがインストールされ、実行されていること — こちらから入手。
  3. Swift 5.9+(Xcode 15+)— ソースからビルドする場合に必要です。ビルド済みバイナリも利用可能です。

ソースからビルド

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

ビルド済みバイナリ

最新の NemetonMCP バイナリを Releases ページ からダウンロードしてください。


設定

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

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

NEMETON_TOKEN は Nemeton → 設定 → API と統合 から取得してください。

Claude Code

~/.claude/mcp.json に追加します(または claude mcp add 経由で)。

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

Cursor / その他の MCP クライアント

同じパターンです。NemetonMCP を、上記 2 つの環境変数を設定した stdio MCP サーバーとして構成します。


仕組み

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

ブリッジは stdin から JSON-RPC 2.0 リクエストを読み取り、Nemeton のローカル HTTP サーバー(127.0.0.1:22100/mcp)に転送し、レスポンスを stdout に書き戻します。認証、VM ロジック、ツールのディスパッチはすべて Nemeton アプリ内で行われます。

この分離により、MCP のワイヤーフォーマットはオープンソースのまま(監査、フォーク、お好みのサンドボックス層での実行が可能)にしつつ、VM の内部実装はアプリ内に留めることができます。


環境変数

変数デフォルト説明
NEMETON_PORT22100Nemeton のローカル HTTP サーバーのポート
NEMETON_TOKEN(なし)Nemeton 設定から取得するベアラートークン(書き込み操作に必須)

エラーとトレースログは stderr に書き込まれるため、JSON-RPC の stdout チャネルを汚しません。


Nemeton について

Nemeton は、Apple の Virtualization.framework を使用して仮想マシンを作成・管理するネイティブ macOS アプリです。主な特長:

  • サブスクリプション不要 — 買い切り、€389
  • Linux および macOS の VM — ISO/IPSW を自動ダウンロード
  • APFS 上の CoW スナップショット — ディスクを無駄にせず VM の状態を保存
  • REST API + WebSocket イベント(42 エンドポイント)による自動化
  • MCP サーバー(本リポジトリ)— Claude/AI エージェント向け
  • ネイティブなパフォーマンス — Apple のフレームワークを直接使用、QEMU のオーバーヘッドなし
  • 100% ローカル — クラウドなし、テレメトリなし

→ Nemeton を store.juergenkoller.software で入手


ライセンス

MIT — LICENSE を参照してください。ブリッジはオープンソースですが、Nemeton アプリ自体は商用です。

問題とサポート

Juergen Koller Software GmbH によって開発されています。