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 サーバー
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 |
| Webhook | list_webhooks, register_webhook, delete_webhook |
| ランタイム | vm_runtime, vm_errors, list_downloads |
各ツールは、VM の状態、スナップショットのメタデータ、コンソール出力、または操作結果を含む構造化 JSON を返します。
インストール
前提条件
- macOS 14(Sonoma)以降 —
Virtualization.frameworkの機能に必要です。 - Nemeton アプリがインストールされ、実行されていること — こちらから入手。
- 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_PORT | 22100 | Nemeton のローカル 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 アプリ自体は商用です。
問題とサポート
- ブリッジのバグ: issue を作成
- アプリのサポート: support@juergenkoller.software
Juergen Koller Software GmbH によって開発されています。