blender-cu-vm-mcp
Blender Computer-Use 分離型仮想マシン & MCPサーバー
ホストデスクトップを妨げず、AIコーディングエージェントがBlenderのUI自動テスト、ユーザーストーリーの検証、Computer-Useワークフローを自律的に実行できるよう、Model Context Protocol(MCP)経由で接続された、GPUパーティション型で分離されたローカルWindows 11仮想マシン環境です。
1. システムアーキテクチャ
+---------------------------------------------------------------------------------------------+
| Coding Agents (Claude Code / OMP / Codex) |
+---------------------------------------------------------------------------------------------+
│
│ (MCP JSON-RPC via stdio)
▼
+─────────────────────────────────────────────────────────────────────────────────────────────+
| Host Layer: `blender-cu-vm-mcp` Server |
| - MCP Tool Handler (Computer Use, Analytical Inspection, Blender Telemetry, File Staging) |
| - VM Lifecycle Manager (Hyper-V Socket / PowerShell WMI / Sub-2s Snapshot Reset) |
+─────────────────────────────────────────────────────────────────────────────────────────────+
│
┌───────────────────────┴───────────────────────┐
│ Hyper-V Socket (HV-SOCK) / Internal VMSwitch │
▼ ▼
+───────────────────────────────────────────────+ +─────────────────────────────────────────+
| Windows 11 Guest VM (Hyper-V) | | Secondary (Fast CI): WSL2 Container |
| - NVIDIA GPU-PV (RTX 4080 Super vGPU: 8GB) | | - Mesa / Direct3D 12 GPU Accel |
| - Virtual Display Driver (1080p Fixed 60Hz) | | - Virtual X11 Display (Xvfb/Weston) |
| - Guest Agent Daemon (FastAPI / gRPC) | | - Guest Agent Daemon (Linux) |
| - In-Process Blender Telemetry Bridge (bpy) | | - Blender bpy IPC Bridge |
+───────────────────────────────────────────────+ +─────────────────────────────────────────+Related MCP server: WindowsPC-MCP
2. 主な機能
ホストに一切影響しない: 合成されたマウスの移動、ドラッグ、クリック、キー操作は、すべてゲストOS内でのみ実行されます。実際のカーソルやウィンドウフォーカスは完全に影響を受けません。
ハードウェアアクセラレーションGPUレンダリング: NVIDIA GPU-PVがゲストVMに対し、ホストのRTX 4090 Super(DirectX 12、Vulkan、OpenGL、CUDA/OptiX)へのネイティブに近いアクセスを提供します。
決定論的な1080pディスプレイ: オープンソースの仮想ディスプレイドライバ(
IddSampleDriver)が仮想画面を1920x1080 @ 60Hz、100%(96 DPI)スケーリングに固定し、座標のドリフトやモニターのスリープを防ぎます。ハイブリッドマルチモーダルフィードバック: エージェントは次の情報を取得します。
視覚: オプションの座標グリッドオーバーレイ付きフレームバッファのスクリーンショット。
分析: Windows UI Automationのツリー、バウンディングボックス、ウィンドウの応答性。
詳細テレメトリ: Blenderの
bpy状態、アクティブなモディファイア、ノードツリーの割り当て、リアルタイムのstdout/stderrログ。
2秒未満の状態ロールバック: 爆発的なHyper-Vスナップショットの復元により、破壊的または実験的な実行後に、VMをクリーンなゴールデンベースへリセットします。
3. ディレクトリ構成
blender-cu-vm/
├── host/ # Host MCP Server & Hyper-V Controller
│ ├── mcp_server.py # Stdio JSON-RPC MCP server with 14 tools
│ ├── hv_transport.py # Hyper-V Socket (AF_HYPERV) & HTTP transport
│ ├── vm_controller.py # PowerShell WMI lifecycle & snapshot manager
│ └── asset_sync.py # Bi-directional file and addon staging
├── guest/ # Guest Agent Daemon (runs inside VM)
│ ├── guest_daemon.py # FastAPI HTTP/HV-SOCK unified server
│ ├── screen_capture.py # DXGI Desktop Duplication & visual diffs
│ ├── input_controller.py # Win32 SendInput (clicks, drags, typing)
│ ├── ui_automation.py # Windows UI Automation tree inspector
│ └── video_recorder.py # Hardware-accelerated NVENC MP4 recorder
├── blender/ # Blender Embedded Runtime Bridge
│ ├── cu_telemetry_bridge.py # Non-blocking TCP telemetry server
│ ├── crash_interceptor.py # C-level stdout/stderr stream tee
│ └── state_inspector.py # Declarative scene invariant checker
├── scripts/ # Automated Setup & Provisioning
│ ├── setup_vm_gpupv.ps1 # Automated Hyper-V Gen2 VM creator
│ ├── stage_gpupv_drivers.ps1 # NVIDIA GPU-PV driver packaging & injection
│ ├── setup_virtual_display.ps1 # Virtual display & autologon configuration
│ └── manage_golden_snapshot.ps1 # Instant snapshot creation & rollback
├── tests/ # Verification & E2E Test Suite
│ ├── test_blender_user_story.py # 12-stage automated test suite
│ └── verify_isolation.py # Zero host disturbance verification
├── mcp-config.json # Registration snippet for Claude Code / OMP
└── README.md4. セットアップとインストールガイド
ステップ1: ホスト上でVMをプロビジョニングする(管理者としてPowerShell)
cd C:\tmp\blender-cu-vm\scripts
.\setup_vm_gpupv.ps1 -VMName "Blender-CU-VM" -MemoryBytes 8GB -ProcessorCount 8ステップ2: NVIDIA GPU-PVドライバを準備する
.\stage_gpupv_drivers.ps1 -VMName "Blender-CU-VM" -Mode "Stage"ステップ3: ゲストOSのインストールと実行環境のセットアップ
ゲストVM内(管理者としてPowerShell):
# 1. Install GPU-PV drivers from staged directory
C:\Temp\NvidiaDrivers\install_gpupv_guest.bat
# 2. Configure Virtual Display & Auto-Logon
.\setup_virtual_display.ps1 -TargetWidth 1920 -TargetHeight 1080
# 3. Start Guest Daemon on boot
python C:\blender-cu-vm\guest\guest_daemon.pyステップ4: ゴールデンベースのスナップショットを作成する
.\manage_golden_snapshot.ps1 -VMName "Blender-CU-VM" -SnapshotName "golden_base" -Action "Create"5. MCP経由でAIコーディングエージェントを接続する
以下を ~/.claude.json または ~/.omp/agent/config.yml に追加します。
{
"mcpServers": {
"blender-cu-vm": {
"command": "python",
"args": [
"C:\\tmp\\blender-cu-vm\\host\\mcp_server.py"
],
"env": {
"BLENDER_VM_NAME": "Blender-CU-VM",
"BLENDER_GUEST_URL": "http://192.168.122.100:8000"
}
}
}
}6. 検証テストの実行
すべてのサブシステムを検証し、シミュレーションされたBlenderユーザーストーリーを実行するには:
python blender-cu-vm/tests/test_blender_user_story.py
python blender-cu-vm/tests/verify_isolation.pyThis server cannot be deployed
Maintenance
Related MCP Connectors
Eyes and hands on real Windows PCs — observe, click, type via Glasswarp API.
Blender and GLB/FBX/USD/STL rendered on cloud GPUs for AI agents: product shots, turntables, MP4
- NoxgildOAuthcom.noxgild
Secure AI access to Windows, macOS, Linux computers and a hosted Cloud Browser.
Persistent Linux computers for AI agents: desktop, signed-in browser, vault, apps and shell.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables autonomous desktop automation by delegating tasks to vision-based agents operating within cloud-based virtual machine sandboxes. It allows users to manage VMs, execute complex computer tasks, and receive text-based screen summaries across Linux, Windows, and macOS environments.2-
- AlicenseNot gradedqualityDmaintenanceGives AI agents their own virtual display on Windows, enabling isolated clicking, typing, and screenshots without interfering with the user's desktop.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to safely test and debug PowerShell, CMD/BAT scripts, and system utilities inside isolated Hyper-V virtual machines, with snapshot rollback, host-to-guest file transfer, PowerShell Direct execution, and autonomous self-correction on failures.1Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables an AI agent to operate Windows applications through vision-driven UI Automation and record polished demo videos with pre-click camera zoom, narration, and cinematic effects.MIT