Blender MCP: điều khiển Blender bằng câu lệnh tự nhiên — ví dụ điển hình của MCP cho app desktop

“Tạo một căn phòng low-poly có bàn gỗ, đèn bàn ánh vàng, camera nhìn từ góc 45 độ” — gõ câu đó vào Claude và thấy Blender tự dựng scene. Đó là MCP for Blender (trước đây tên blender-mcp), một plugin cộng đồng của ahujasid với hơn 28.000 sao GitHub. Ngoài việc thú vị cho người làm 3D, nó còn là ví dụ rất rõ về cách MCP biến một phần mềm desktop có scripting API thành “tool” cho agent.

Cách hoạt động

[Claude Code / Claude Desktop / Cursor]
          |  MCP (tool call)
          v
[MCP server: mcp-for-blender]  (chạy bằng uvx)
          |  JSON qua TCP socket, mặc định localhost:9876
          v
[Addon trong Blender]  -> chạy lệnh bằng Python API của Blender

• Addon tạo một socket server bên trong Blender, nhận lệnh và thực thi.
• MCP server nhận tool call từ client AI và chuyển thành lệnh JSON gửi qua socket.
• Agent làm việc trên dữ liệu có cấu trúc của scene (object, vật liệu, camera) chứ không bấm chuột theo ảnh chụp màn hình — nhanh và ổn định hơn nhiều.

Cài đặt

Cách nhanh

uvx mcp-for-blender setup

Lệnh này cài uv nếu chưa có, tự tìm các MCP client trên máy, thêm mục blender vào cấu hình của chúng, rồi cài và bật addon trong Blender. Gói đã đổi tên từ blender-mcp sang mcp-for-blender; cấu hình cũ dùng uvx blender-mcp vẫn chạy.

Cách thủ công

# Cài uv bằng installer chính thức (không dùng pip install uv)

# Đăng ký MCP server
claude mcp add blender uvx mcp-for-blender            # Claude Code
codex mcp add blender -- uvx mcp-for-blender          # Codex

# Cài addon
uvx mcp-for-blender install-addon
# Trong Blender: Edit → Preferences → Add-ons → bật "Interface: MCP for Blender"

Claude Desktop, Cursor, VS Code dùng mục JSON với "command": "uvx" và "args": ["mcp-for-blender"].

Khởi động

Trong viewport 3D, nhấn N → tab MCP for Blender → bấm Start MCP Server. Sau đó client AI sẽ thấy các tool Blender.

Các tool chính

Prompt mẫu

Tạo scene ngục tối low-poly có rồng canh giữ một hũ vàng.
Lấy texture đá từ Poly Haven ở độ phân giải 1k.
Đặt ánh sáng ấm từ đuốc, rồi chụp lại góc camera để tôi xem.

Mẹo: chia yêu cầu phức tạp thành nhiều bước nhỏ để tránh timeout; yêu cầu agent dùng look sau mỗi bước để tự kiểm tra.

An toàn và giới hạn

• execute_blender_code chạy Python tuỳ ý — luôn lưu file trước, đừng thử trên scene quan trọng.
• Bật BLENDER_MCP_SAFE_MODE=1 để kiểm tra script trước khi chạy và chặn thao tác rủi ro (truy cập file, chạy chương trình khác, truy cập mạng).
• Socket không có xác thực hay mã hoá — giữ ở localhost; cần truy cập từ xa thì dùng SSH tunnel.
• Chỉ chạy một MCP server cho một Blender (ví dụ Cursor hoặc Claude Desktop, không cả hai).
• Telemetry: mặc định thu bản ghi sử dụng ẩn danh tối thiểu; prompt, code, ảnh chỉ thu khi bạn đồng ý. Tắt hoàn toàn bằng DISABLE_TELEMETRY=true.
• Tải asset Poly Haven có thể làm đơ giao diện Blender — chọn độ phân giải 1k hoặc 2k.

Gỡ lỗi nhanh

• Lỗi spawn uvx ENOENT: dùng đường dẫn đầy đủ tới uvx trong cấu hình (tìm bằng which uvx), rồi khởi động lại hoàn toàn client.
• Đừng tự chạy lệnh uvx trong terminal — client AI sẽ tự khởi chạy server.
• Lỗi kết nối kéo dài: khởi động lại cả client AI lẫn server trong Blender.
• Chạy nhiều Blender cùng lúc: đổi cổng bằng --port hoặc BLENDER_PORT.

Bài học rộng hơn: MCP cho app desktop

Mẫu “addon trong app + MCP server bên ngoài + giao tiếp qua socket” áp dụng được cho rất nhiều phần mềm có scripting API: Godot, Unity, Figma, bộ Office, phần mềm CAD… Khi agent thao tác qua API thay vì qua giao diện, nó vừa nhanh, vừa ít lỗi, vừa dễ kiểm soát quyền hơn.

Áp dụng thế nào?

• Dev / 3D artist: Dùng để dựng nhanh scene thô, đặt ánh sáng, nhập asset — phần tinh chỉnh vẫn tự làm.
• Tech Lead: Nếu công ty có phần mềm nội bộ với scripting API, đây là kiến trúc tham khảo để làm MCP riêng. Nhớ: localhost, safe mode, giới hạn tool.
• PM: Prototype hình ảnh 3D cho pitch hoặc demo sản phẩm giờ có thể làm trong một buổi chiều bằng câu lệnh tự nhiên.