Skip to content
Back to search

uno-blender-mcp

High-Level Headless Blender MCP Server (Studio Scene, 360 Turntable, & bpy Automation) by U-NO AI Studio

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/suprombb3131-code--uno-blender-mcp/badge.svg)](/listings/suprombb3131-code--uno-blender-mcp)

HTML

<a href="/listings/suprombb3131-code--uno-blender-mcp"><img src="/api/listings/suprombb3131-code--uno-blender-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/suprombb3131-code/uno-blender-mcp.git
cd uno-blender-mcp
npm install

Or run directly if installed globally / via `npx`:

npm start

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 89 lines
  1. # `uno-blender-mcp`
  2. **High-Level Headless Blender MCP Server** by **U-NO AI Studio (Arun & ALISE)**
  3. Control Blender via the **Model Context Protocol (MCP)** in **Headless Background Mode (`--background`)** — no need to keep the Blender GUI open! Built for AI agents (Claude Desktop, Cursor, Windsurf, ALISE, or any MCP client) to generate 3D studio scenes, render 360° turntable videos, and execute custom `bpy` Python scripts effortlessly.
  4. ---
  5. ## Why `uno-blender-mcp`?
  6. Most existing Blender MCP servers require keeping a Blender UI window open and running a socket add-on, or only expose low-level mesh/axis primitives.
  7. `uno-blender-mcp` is designed for **production-ready, zero-UI automation**:
  8. - **Zero-UI Headless Execution**: Runs Blender directly in `--background` mode via `StdioServerTransport`.
  9. - **High-Level Studio Presets**: Instantly spin up a dark studio environment with 3-point lighting, metallic materials, camera tracking, and 3D text/primitives in one tool call.
  10. - **One-Shot 360° Turntable Video**: Import `.blend`, `.glb`, `.gltf`, `.obj`, or `.fbx` and render a vertical (`1080x1920`) or custom H.264 `.mp4` turntable video.
  11. - **Full `bpy` Escape Hatch**: Run any custom Blender Python script when you need total control.
  12. - **Cross-Platform Path Detection**: Auto-detects Blender on Windows (`D:\Apps\Blender`, `C:\Program Files\Blender Foundation\Blender 5.3 / 4.3 / 4.2`), macOS, and Linux `PATH`, or via `BLENDER_PATH`.
  13. ---
  14. ## Tools Included
  15. | Tool | Description |
  16. | :--- | :--- |
  17. | `blender_status` | Check Blender executable path, version, and confirm headless mode readiness. |
  18. | `blender_create_studio_scene` | Create a 3D studio scene (`CUBE`, `SPHERE`, `TORUS`, or `TEXT`) with 3-point area lighting, Principled BSDF material, camera, and optional `.blend` save / `.png` render (`BLENDER_EEVEE_NEXT`, `BLENDER_EEVEE`, `CYCLES`). |
  19. | `blender_render_turntable` | Load `.blend`, `.glb`, `.gltf`, `.obj`, or `.fbx` and render a 360° camera-orbit `.mp4` (H.264) animation. |
  20. | `blender_run_python` | Execute any custom Blender Python (`bpy`) script in headless background mode. |
  21. ---
  22. ## Requirements
  23. - **Node.js** `>= 18`
  24. - **Blender** `4.2+` / `4.3` / `5.3` installed on your machine
  25. ---
  26. ## Installation
  27. ```bash
  28. git clone https://github.com/suprombb3131-code/uno-blender-mcp.git
  29. cd uno-blender-mcp
  30. npm install
  31. ```
  32. Or run directly if installed globally / via `npx`:
  33. ```bash
  34. npm start
  35. ```
  36. ---
  37. ## MCP Client Configuration
  38. ### Claude Desktop (`claude_desktop_config.json`) / Cursor / Windsurf
  39. ```json
  40. {
  41. "mcpServers": {
  42. "uno-blender-mcp": {
  43. "command": "node",
  44. "args": ["D:/ALICE/uno-blender-mcp/index.mjs"],
  45. "env": {
  46. "BLENDER_PATH": "C:\\Program Files\\Blender Foundation\\Blender 5.3\\blender.exe"
  47. }
  48. }
  49. }
  50. }
  51. ```
  52. > **Note:** `BLENDER_PATH` is optional if Blender is installed in one of the default locations or available in your system `PATH`.
  53. ---
  54. ## Example Prompts for AI Agents
  55. - *"Check if Blender is ready using `blender_status`."*
  56. - *"Create a 3D studio scene with the text `U-NO 3D` using `blender_create_studio_scene` and render it to `D:/renders/uno-logo.png`."*
  57. - *"Render a 360-degree vertical turntable MP4 (`1080x1920`) of `D:/models/product.glb` to `D:/renders/product_360.mp4`."*
  58. - *"Run a custom `bpy` script via `blender_run_python` to inspect all mesh objects in my scene."*
  59. ---
  60. ## License
  61. MIT © [U-NO AI Studio](https://unoaistudio.com) (Arun & ALISE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.