Skip to main content
Glama

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)スケーリングに固定し、座標のドリフトやモニターのスリープを防ぎます。

  • ハイブリッドマルチモーダルフィードバック: エージェントは次の情報を取得します。

    1. 視覚: オプションの座標グリッドオーバーレイ付きフレームバッファのスクリーンショット。

    2. 分析: Windows UI Automationのツリー、バウンディングボックス、ウィンドウの応答性。

    3. 詳細テレメトリ: 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.md

4. セットアップとインストールガイド

ステップ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.py

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables 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
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables 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.
    1
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables 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