Nemeton MCP

официальный

Открытый MCP-мост для Nemeton: создание, запуск, создание снимков и управление нативными виртуальными машинами macOS из Claude Desktop, Claude Code или Cursor, включая автоматизацию пользовательского интерфейса внутри гостевой системы. Работает локально на Apple silicon.

GitHub

Что можно делать с Nemeton MCP?

Создание и настройка виртуальных машин — Попросите ассистента создать виртуальную машину с выбранным дистрибутивом, количеством процессоров и объёмом оперативной памяти, а затем обновить или клонировать её позже.
Управление состоянием питания виртуальных машин — Запускайте, останавливайте, приостанавливайте, возобновляйте, приостанавливайте с сохранением состояния или принудительно останавливайте виртуальные машины, а также проверяйте статус приостановки.
Выполнение команд по SSH — Используйте ssh_execute для выполнения команд внутри виртуальной машины и vm_ip для определения её адреса.
Передача файлов — Загружайте, скачивайте и просматривайте список файлов внутри виртуальной машины с помощью file_upload, file_download и file_list.
Управление снимками — Создавайте, просматривайте, восстанавливайте и удаляйте CoW-снимки виртуальной машины.
Чтение консоли и снимков экрана — Отправляйте ввод в консоль, читайте вывод, выполняйте консольные команды и делайте снимки экрана.

Документация

Nemeton MCP Server

Управляйте нативными виртуальными машинами macOS из Claude Desktop, Claude Code, Cursor или любого MCP-клиента.

Это официальный мост Model Context Protocol для Nemeton — нативного приложения для macOS, которое создаёт и управляет виртуальными машинами Linux и macOS с помощью Virtualization.framework от Apple (без Parallels, без VMware, без подписок).

Вам нужно установить и запустить приложение Nemeton. Этот MCP-сервер — тонкий мост stdio→HTTP; вся логика работы с виртуальными машинами находится в приложении. Скачать Nemeton можно на store.juergenkoller.software/apps/nemeton.

Что вы можете делать

«Claude, подними виртуальную машину Ubuntu 24.04 с 4 процессорами и 8 ГБ ОЗУ, установи 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 на 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	`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 с состоянием ВМ, метаданными снимков, выводом консоли или результатом операции.

Установка

Предварительные требования

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 со страницы релизов.

Конфигурация

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-клиенты

Тот же принцип: настройте NemetonMCP как stdio MCP-сервер с двумя переменными окружения, указанными выше.

Как это работает

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

Мост читает запросы JSON-RPC 2.0 из stdin, пересылает их на локальный HTTP-сервер Nemeton по адресу 127.0.0.1:22100/mcp и записывает ответы обратно в stdout. Вся аутентификация, логика работы с ВМ и диспетчеризация инструментов происходят внутри приложения Nemeton.

Такое разделение позволяет нам держать формат протокола MCP открытым (чтобы вы могли его проверить, форкнуть или запустить через любой предпочитаемый слой песочницы), в то время как внутренняя реализация ВМ остаётся в приложении.

Переменные окружения

Переменная	По умолчанию	Описание
`NEMETON_PORT`	`22100`	Порт локального HTTP-сервера Nemeton
`NEMETON_TOKEN`	(нет)	Bearer-токен из настроек Nemeton (требуется для операций записи)

Ошибки и трассировочные логи записываются в stderr, чтобы не засорять канал stdout JSON-RPC.

О Nemeton

Nemeton — нативное приложение для macOS для создания и управления виртуальными машинами с помощью Virtualization.framework от Apple. Основные возможности:

Без подписки — разовая покупка, €389
ВМ Linux и macOS с автоматической загрузкой ISO/IPSW
Снимки CoW на APFS — сохраняйте состояния ВМ без лишнего расхода диска
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.