Nemeton Mcp

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、CPU 4 個、メモリ 8 GB の 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 を返します。

---

インストール

前提条件

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 → Settings → API & Integrations から取得できます。

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 クライアント

同じ方法で、上記の 2 つの環境変数を使用する stdio MCP サーバーとして NemetonMCP を設定します。

---

仕組み

┌────────────────┐  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% ローカル — クラウドなし、テレメトリーなし

→ store.juergenkoller.software で Nemeton を入手

---

ライセンス

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

問題とサポート

• ブリッジの不具合： 問題を報告
• アプリのサポート： [email protected]

Juergen Koller Software GmbH が開発しました。