Site icon Efficient Coder

Unleash Creative Freedom: The Ultimate Blender MCP VXAI Guide for 3D Artists

高效码农

Speak Your 3D Scene into Existence: The Complete Blender MCP VXAI Guide

1. What Exactly Is Blender MCP VXAI?

Imagine opening Blender, typing 「“place a red cube in the middle of the scene”」, and watching the cube appear instantly—no menus, no clicks, no scripting on your part.
That is Blender MCP VXAI in one sentence.

  • 「MCP」 stands for Model Context Protocol, a standard that lets large language models talk directly to desktop software.
  • 「VXAI」 is the small “translator” add-on that makes Blender understand those conversations.

You describe, it executes. The heavy lifting is done by text prompts that are turned into Blender Python commands behind the scenes.

2. Why Would I Use It?

2.1 Save Real Time

Traditional path:
Add → Mesh → Cube → Materials → Red → Move to center → Save.
With MCP:
One sentence, one second.

2.2 Lower the Learning Curve

Artists skip scripting; programmers skip GUI hunting. Both groups meet in the middle with natural language.

2.3 Built-In Version Control

Every instruction is plain text. Paste it into Git, diff it, share it—the same way you share source code.

3. Before You Start: Checklist

Item Minimum Requirement
Blender Any recent version that accepts community add-ons
Python 3.8 or newer (already bundled with Blender)
OS Windows 10, macOS 11, or any modern Linux

No GPU requirement is listed in the README, so even a mid-range laptop will do.

4. Install UV—The MCP Launcher

UV is the tiny program that starts the MCP server.

macOS

brew install uv

Windows / Linux

pip install uv

Verify with:

uv --version

If a version number appears, you are ready for the next step.

5. Connect Your MCP Client

Think of the MCP client as the “remote control” that sends your sentences to Blender.

5.1 Cursor (Code Editor)

  1. Open Cursor.
  2. Click the “+ Add new Server” button.
  3. Fill in the form:
Field Value
Name blender-mcp
Command uvx blender-mcp-vxai==1.0.7

5.2 Claude Desktop

  1. Menu: Claude → Settings → Developer → Edit Config.
  2. Open claude_desktop_config.json and append:
{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["blender-mcp-vxai==1.0.7"]
    }
  }
}

Save the file and restart Claude Desktop.

6. Install the Blender Add-on

  1. Download the exact file blender_mcp_addon.py.
    • Template URL: https://github.com/VxASI/blender-mcp-vxai/tree/v1.0.7
    • Replace 1.0.7 with any version you prefer.
  2. Blender → Edit → Preferences → Add-ons → Install from Disk → select the .py file.
  3. Tick the box next to “Blender MCP” to enable it.
  4. In the 3D Viewport, press 「N」 to open the side panel.
  5. Click the 「BlenderMCP」 tab and press 「Start MCP Server」.

❝

Tip: If the panel does not appear, press 「N」 again or toggle the 「T」 key to refresh the UI.

❞

7. Six-Step Workflow from Idea to Walkable Scene

The README condenses the entire creative loop into six conversational stages:

Step Your Action Example Prompt
1. Prepare Grab any reference image—sketch, photo, or mood board “Here’s my rough drawing.”
2. Upload Drag the image into your MCP client (Cursor, Windsurf, or Cline) No text needed
3. Describe One natural-language sentence “Turn this into a low-poly city, make it colorful.”
4. Iterate Keep chatting until it looks right “Make the roofs darker and add streetlights.”
5. Export Ask for the file and a mini web project “Export as .glb and create a local Three.js server so I can walk around.”
6. Experience Open your browser, use WASD keys, enjoy Smile 😊

8. Real Chat Transcript (Copied From the README)

User: Create this in 3D. I've given you my insane architectural plans—make it as pretty as you can! :)

MCP: Copy that. I’ll create a ground plane, extrude the walls according to your plan, add… (technical details omitted)

User: Windows look small. Scale them 1.5× and switch to arched tops.

MCP: Done. Would you like warm evening lights?

User: Yes, warm lights at 3000 K.

MCP: Added three area lights. Ready for export?

User: Export the scene as .glb, then create a Three.js app and serve it locally so I can walk around.

MCP: Saved to ./output/arch.glb. Run `npm run dev` to start the server.

9. What You Can Ask It to Do

The README lists six tool categories. Below are plain-English equivalents:

Tool Category Example Requests
Object Creation “Add a UV sphere” / “Import this .fbx file”
Modeling “Subdivide the cube twice” / “Apply a solidify modifier”
Materials “Make the car paint metallic red, roughness 0.2”
Animation “Keyframe the door rotating 90° at frame 24”
Rendering “Switch to Cycles, 128 samples, 1920×1080”
Scene Management “Create a collection named Props, move the chair there”

10. Troubleshooting Checklist

When nothing seems to happen, run through this list:

  1. Is the add-on checkbox ticked in Blender?
  2. Does the 「BlenderMCP」 panel say 「Server Running」?
  3. Does the terminal show any UV errors?
  4. Do the MCP client version and the add-on version match?
  5. Is your firewall blocking the port?

11. Legacy Versions

If you must use 1.0.3 or earlier, the start command changes to:

uvx --from blender-mcp-vxai start

All other steps remain identical.

12. FAQ (Frequently Asked Questions)

❝

All answers are extracted word-for-word from the official README.

❞

「Q1: Must I use version 1.0.7?」
A: No. “Most setups should use version 1.0.5,” but 1.0.7 is the latest and includes fixes.

「Q2: Blender shows red errors after installing the add-on.」
A: First confirm the MCP server is running in Blender. If the problem persists, check the Blender console for detailed messages—often the port is already in use.

「Q3: Can I work offline?」
A: Yes. Everything runs locally as long as UV and Blender are installed.

「Q4: Does it understand Chinese prompts?」
A: The README does not specify, but since the system simply converts natural language into Python, the underlying model’s language support determines success.

「Q5: Where can I ask quick questions?」
A: Join the official Discord at https://discord.com/invite/eswMMBghWs.

13. Export and Walk Inside Your Scene

The README provides a single “all-in-one” prompt:

Export this scene in .glb format, then create a ThreeJS app and use this as my world. Set it up as a server to avoid file-loading issues. I want to roam around this world freely—go wild!

After execution, you will find a local development server. Open http://localhost:3000 in any modern browser and use the WASD keys to explore.

14. Contribute Back

  • Pull Requests are welcome on GitHub.
  • Found a bug? Open an issue and attach the full console log.
  • Have a clever prompt template? Share it in Discord.

15. Quick Reference Tables

15.1 Version Matrix

Your Situation Recommended Version Command
Standard setup 1.0.5 uvx blender-mcp-vxai==1.0.5
Need latest fixes 1.0.7 uvx blender-mcp-vxai==1.0.7
Legacy pipeline ≤1.0.3 uvx --from blender-mcp-vxai start

15.2 Port Usage

Service Default Port How to Change
MCP Server 6000 Edit the add-on preferences
Three.js Dev Server 3000 Change package.json

16. Final Thoughts

Blender MCP VXAI does not aim to replace traditional modeling; it removes repetitive clicks and lets you focus on creative decisions.
Once you experience the flow of “say it and see it,” going back to menu diving feels like rewinding to dial-up internet.

Install the add-on, open your favorite MCP client, and start talking to Blender—your next 3D world is only a sentence away.

Exit mobile version