Nemeton Mcp

Nemeton MCP 服务

通过 Claude Desktop、Claude Code、Cursor 或任意 MCP 客户端控制原生 macOS 虚拟机。

这是 Nemeton 的官方 Model Context Protocol 桥接程序。Nemeton 是一款原生 macOS 应用，使用 Apple 的 Virtualization.framework 创建和管理 Linux 与 macOS 虚拟机（无需 Parallels、无需 VMware、无需订阅）。

你需要安装并运行 Nemeton 应用。 此 MCP 服务是一个精简的 stdio→HTTP 桥接程序——实际的虚拟机逻辑由应用负责。请前往 store.juergenkoller.software/apps/nemeton 获取 Nemeton。

---

你可以做什么

“Claude，启动一台配有 4 个 CPU 和 8 GB RAM 的 Ubuntu 24.04 虚拟机，安装 Docker，并在准备就绪时告诉我。”

MCP 服务提供 50 多个工具，涵盖以下类别：

类别	工具
虚拟机生命周期	list_vms、get_vm、create_vm、update_vm、clone_vm、delete_vm、reorder_vms、stop_all
虚拟机控制	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
Webhooks	list_webhooks、register_webhook、delete_webhook
运行时	vm_runtime、vm_errors、list_downloads

每个工具都会返回结构化 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

预构建二进制文件

从 Releases 页面下载最新的 NemetonMCP 二进制文件。

---

配置

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 → Settings → API & Integrations 获取 NEMETON_TOKEN。

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 配置为 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	(none)	Nemeton 设置中的 Bearer 令牌（写入操作必需）

错误和跟踪日志会写入 stderr，以免污染 JSON-RPC 的 stdout 通道。

---

关于 Nemeton

Nemeton 是一款原生 macOS 应用，使用 Apple 的 Virtualization.framework 创建和管理虚拟机。主要特点：

• 无需订阅 — 一次性购买，€389
• Linux 和 macOS 虚拟机，支持自动下载 ISO/IPSW
• APFS 上的 CoW 快照 — 保存虚拟机状态而不浪费磁盘空间
• REST API + WebSocket 事件（42 个端点），用于自动化
• MCP 服务（本仓库），适用于 Claude/AI Agent
• 原生性能 — 直接使用 Apple 的框架，无 QEMU 开销
• 100% 本地运行 — 无云服务、无遥测

→ 在 store.juergenkoller.software 获取 Nemeton

---

许可证

MIT — 详见 LICENSE。桥接程序是开源的；Nemeton 应用本身为商业软件。

问题与支持

• 桥接程序问题： 提交问题
• 应用支持： [email protected]

由 Juergen Koller Software GmbH 构建。