内容
# 尼米頓 MCP 服务器
[](https://swift.org)
[](https://apple.com/macos)
[](LICENSE)
[](https://modelcontextprotocol.io)
[](https://glama.ai/mcp/servers/juergenkoller-software/nemeton-mcp)
**从克劳德桌面、克劳德代码、光标或任何MCP客户端控制本地macOS虚拟机。**
这是官方的 [模型上下文协议](https://modelcontextprotocol.io) 桥接器，用于 [**尼米頓**](https://store.juergenkoller.software/en/apps/nemeton) — 一个本地macOS应用程序，使用苹果的 `Virtualization.framework` 创建和管理Linux和macOS虚拟机（无需Parallels、VMware或订阅）。
> **您需要安装并运行尼米頓应用程序。** 此MCP服务器是一个薄的stdio→HTTP桥接器 — 实际的虚拟机逻辑存在于应用程序中。在 [store.juergenkoller.software/apps/nemeton](https://store.juergenkoller.software/en/apps/nemeton) 获取尼米頓。
---
## 您可以使用
> “克劳德，启动一个Ubuntu 24.04虚拟机，配备4个CPU和8 GB内存，安装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` |
| **快照** (CoW on APFS) | `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_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` |
| **网络钩子** | `list_webhooks`, `register_webhook`, `delete_webhook` |
| **运行时** | `vm_runtime`, `vm_errors`, `list_downloads` |
每个工具都返回具有虚拟机状态、快照元数据、控制台输出或操作结果的结构化JSON。
---
## 安装
### 先决条件
1. **macOS 14 (Sonoma) 或更高版本** — 需要 `Virtualization.framework` 功能。
2. **已安装并运行的尼米頓应用程序** — [在此处获取](https://store.juergenkoller.software/en/apps/nemeton)。
3. **Swift 5.9+** （Xcode 15+），如果您想从源代码构建。可用的预构建二进制文件。
### 从源代码构建
```bash
git clone https://github.com/juergenkoller-software/nemeton-mcp.git
cd nemeton-mcp
swift build -c release
# 二进制文件：.build/release/NemetonMCP
```
### 预构建二进制文件
从 [发布页面](https://github.com/juergenkoller-software/nemeton-mcp/releases) 下载最新的 `NemetonMCP` 二进制文件。
---
## 配置
### 克劳德桌面
编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"nemeton": {
"command": "/path/to/NemetonMCP",
"env": {
"NEMETON_PORT": "22100",
"NEMETON_TOKEN": "your-token-here"
}
}
}
}
```
从 **尼米頓 → 设置 → API & 集成** 获取 `NEMETON_TOKEN`。
### 克劳德代码
添加到 `~/.claude/mcp.json` （或通过 `claude mcp add`）：
```bash
claude mcp add nemeton /path/to/NemetonMCP \
--env NEMETON_PORT=22100 \
--env NEMETON_TOKEN=your-token-here
```
### 光标 / 其他MCP客户端
相同的模式：配置 `NemetonMCP` 作为stdio MCP服务器，带有上述两个环境变量。
---
## 工作原理
```
┌────────────────┐ JSON-RPC stdio ┌────────────────┐ HTTP+Bearer ┌────────────────┐
│ 克劳德/光标 │ ───────────────► │ NemetonMCP │ ─────────────► │ 尼米頓.app │
│ （MCP客户端） │ ◄─────────────── │ （此仓库） │ ◄───────────── │ （端口22100） │
└────────────────┘ └────────────────┘ └────────────────┘
```
桥接器从 `stdin` 读取JSON-RPC 2.0请求，将它们转发到尼米頓的本地HTTP服务器 `127.0.0.1:22100/mcp`，并将响应写回 `stdout`。所有身份验证、虚拟机逻辑和工具调度都在尼米頓应用程序中完成。
这种分离使我们能够保持MCP线缆格式开放源代码（这样您可以审计它、分支它或通过您喜欢的任何沙盒层运行它），而虚拟机内部则保留在应用程序中。
---
## 环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
| `NEMETON_PORT` | `22100` | 尼米頓的本地HTTP服务器端口 |
| `NEMETON_TOKEN` | _(无)_ | 来自尼米頓设置的Bearer令牌（写入操作需要） |
错误和跟踪日志写入 `stderr`，以便它们不会污染JSON-RPC stdout通道。
---
## 关于尼米頓
尼米頓是一个使用苹果 `Virtualization.framework` 创建和管理虚拟机的本地macOS应用程序。亮点：
- **无订阅** — 一次购买，€389
- **Linux 和 macOS 虚拟机**，自动下载ISO/IPSW
- **APFS上的CoW快照** — 节省虚拟机状态，无需浪费磁盘
- **REST API + WebSocket事件** （42个端点）用于自动化
- **MCP服务器** （此仓库）用于克劳德/ AI代理
- **原生性能** — 直接使用苹果框架，无QEMU开销
- **100% 本地** — 无云，无遥测
→ **[在store.juergenkoller.software获取尼米頓](https://store.juergenkoller.software/en/apps/nemeton)**
---
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)。桥接器是开源的；尼米頓应用程序本身是商业性的。
## 问题和支持
- **桥接器错误：** [打开问题](https://github.com/juergenkoller-software/nemeton-mcp/issues)
- **应用程序支持：** [support@juergenkoller.software](mailto:support@juergenkoller.software)
由 [Juergen Koller Software GmbH](https://juergenkoller.software) 构建。
