Nemeton MCP

공식

Nemeton용 오픈소스 MCP 브리지: Claude Desktop, Claude Code 또는 Cursor에서 네이티브 macOS 가상 머신을 생성, 시작, 스냅샷 및 제어하며, 게스트 내부의 UI 자동화도 포함합니다. Apple silicon에서 로컬로 실행됩니다.

GitHub

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와 8GB 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`
웹훅	`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

미리 빌드된 바이너리

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_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)  │
└────────────────┘                   └────────────────┘                └────────────────┘

브리지는 stdin에서 JSON-RPC 2.0 요청을 읽고, 이를 127.0.0.1:22100/mcp의 Nemeton 로컬 HTTP 서버로 전달한 뒤, 응답을 stdout에 다시 씁니다. 모든 인증, VM 로직, 도구 디스패치는 Nemeton 앱 내부에서 이루어집니다.

이러한 분리를 통해 MCP 와이어 형식은 오픈 소스로 유지하여(감사하거나, 포크하거나, 원하는 샌드박싱 계층을 통해 실행할 수 있음) VM 내부는 앱에 남겨둘 수 있습니다.

환경 변수

변수	기본값	설명
`NEMETON_PORT`	`22100`	Nemeton 로컬 HTTP 서버의 포트
`NEMETON_TOKEN`	(없음)	Nemeton Settings의 Bearer 토큰 (쓰기 작업에 필요)

오류 및 추적 로그는 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 앱 자체는 상용입니다.

이슈 및 지원

브리지 버그: 이슈 열기
앱 지원: support@juergenkoller.software

Juergen Koller Software GmbH에서 제작했습니다.