Nemeton MCP

Máy chủ Nemeton MCP

Điều khiển máy ảo macOS gốc từ Claude Desktop, Claude Code, Cursor hoặc bất kỳ ứng dụng khách MCP nào.

Đây là cầu nối chính thức của Model Context Protocol dành cho Nemeton — một ứng dụng macOS gốc giúp tạo và quản lý máy ảo Linux và macOS bằng Virtualization.framework của Apple (không cần Parallels, không cần VMware, không cần đăng ký định kỳ).

Bạn cần cài đặt và chạy ứng dụng Nemeton. Máy chủ MCP này chỉ là một cầu nối mỏng stdio→HTTP — logic máy ảo thực sự nằm trong ứng dụng. Tải Nemeton tại store.juergenkoller.software/apps/nemeton.

---

Bạn có thể làm gì

"Claude, khởi tạo một máy ảo Ubuntu 24.04 với 4 CPU và 8 GB RAM, cài Docker, và báo cho tôi khi xong."

Máy chủ MCP cung cấp hơn 50 công cụ thuộc các nhóm sau:

Nhóm	Công cụ
Vòng đời máy ảo	list_vms, get_vm, create_vm, update_vm, clone_vm, delete_vm, reorder_vms, stop_all
Điều khiển máy ảo	start_vm, stop_vm, force_stop_vm, pause_vm, resume_vm, suspend_vm, get_suspend_status
Ảnh chụp nhanh (CoW trên APFS)	list_snapshots, create_snapshot, restore_snapshot, delete_snapshot
Bảng điều khiển	send_console, read_console, console_execute, take_screenshot
Mạng & Tệp	vm_ip, ssh_execute, file_upload, file_download, file_list
Điều khiển GUI	gui_launch, gui_windows, vscode_command, select_vm
Cầu nối Clipboard	clipboard_read, clipboard_write
Thông tin máy chủ	get_host_info, get_metrics
Lưu trữ	resize_disk, export_vm, import_vm
Bản phân phối	list_distros (Ubuntu, Debian, Fedora, Arch — tự động tải ISO)
Màn hình	fullscreen_enter, fullscreen_exit, fullscreen_toggle
Webhook	list_webhooks, register_webhook, delete_webhook
Thời gian chạy	vm_runtime, vm_errors, list_downloads

Mỗi công cụ trả về JSON có cấu trúc bao gồm trạng thái máy ảo, siêu dữ liệu ảnh chụp nhanh, đầu ra bảng điều khiển hoặc kết quả thao tác.

---

Cài đặt

Yêu cầu tiên quyết

1. macOS 14 (Sonoma) trở lên — cần thiết cho các tính năng Virtualization.framework.
2. Ứng dụng Nemeton đã cài đặt và đang chạy — tải tại đây.
3. Swift 5.9+ (Xcode 15+) nếu bạn muốn biên dịch từ mã nguồn. Bản nhị phân dựng sẵn cũng có sẵn.

Biên dịch từ mã nguồn

git clone https://github.com/juergenkoller-software/nemeton-mcp.git
cd nemeton-mcp
swift build -c release
# Binary: .build/release/NemetonMCP

Bản nhị phân dựng sẵn

Tải bản nhị phân NemetonMCP mới nhất từ trang Releases.

---

Cấu hình

Claude Desktop

Chỉnh sửa ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "nemeton": {
      "command": "/path/to/NemetonMCP",
      "env": {
        "NEMETON_PORT": "22100",
        "NEMETON_TOKEN": "your-token-here"
      }
    }
  }
}

Lấy NEMETON_TOKEN từ Nemeton → Settings → API & Integrations.

Claude Code

Thêm vào ~/.claude/mcp.json (hoặc qua claude mcp add):

claude mcp add nemeton /path/to/NemetonMCP \
  --env NEMETON_PORT=22100 \
  --env NEMETON_TOKEN=your-token-here

Cursor / các ứng dụng khách MCP khác

Cùng một cách: cấu hình NemetonMCP như một máy chủ MCP stdio với hai biến môi trường ở trên.

---

Cách hoạt động

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

Cầu nối đọc các yêu cầu JSON-RPC 2.0 từ stdin, chuyển tiếp chúng đến máy chủ HTTP cục bộ của Nemeton tại 127.0.0.1:22100/mcp, và ghi phản hồi trở lại stdout. Toàn bộ việc xác thực, logic máy ảo và điều phối công cụ đều diễn ra bên trong ứng dụng Nemeton.

Cách tách biệt này cho phép chúng tôi giữ định dạng truyền tải MCP mã nguồn mở (để bạn có thể kiểm tra, fork hoặc chạy nó qua bất kỳ lớp sandbox nào bạn muốn) trong khi phần nội bộ máy ảo vẫn nằm trong ứng dụng.

---

Biến môi trường

Biến	Mặc định	Mô tả
NEMETON_PORT	22100	Cổng của máy chủ HTTP cục bộ Nemeton
NEMETON_TOKEN	(không có)	Mã thông báo Bearer từ Nemeton Settings (bắt buộc cho các thao tác ghi)

Lỗi và nhật ký theo dõi được ghi vào stderr để chúng không làm nhiễu kênh stdout của JSON-RPC.

---

Giới thiệu về Nemeton

Nemeton là một ứng dụng macOS gốc để tạo và quản lý máy ảo bằng Virtualization.framework của Apple. Điểm nổi bật:

• Không đăng ký định kỳ — mua một lần, €389
• Máy ảo Linux & macOS với tự động tải ISO/IPSW
• Ảnh chụp nhanh CoW trên APFS — lưu trạng thái máy ảo mà không lãng phí dung lượng đĩa
• REST API + sự kiện WebSocket (42 điểm cuối) cho tự động hóa
• Máy chủ MCP (kho lưu trữ này) cho Claude/các tác nhân AI
• Hiệu năng gốc — sử dụng trực tiếp framework của Apple, không có chi phí phụ trội từ QEMU
• 100% cục bộ — không đám mây, không thu thập dữ liệu từ xa

→ Tải Nemeton tại store.juergenkoller.software

---

Giấy phép

MIT — xem LICENSE. Cầu nối là mã nguồn mở; bản thân ứng dụng Nemeton là thương mại.

Vấn đề & hỗ trợ

• Lỗi cầu nối: mở một issue
• Hỗ trợ ứng dụng: support@juergenkoller.software

Được phát triển bởi Juergen Koller Software GmbH.