ahujasid/mcp-for-blender

What is MCP for Blender?

MCP for Blender is a tool that lets you control the 3D modeling software Blender using natural language through an AI assistant like Claude, Codex, or Cursor. It acts as a bridge between the AI and Blender, so you can say things like "create a red cube" or "add a material to that sphere" and the AI will make it happen in your Blender scene.

It's built on the Model Context Protocol (MCP), a standard way for AI apps to talk to external tools. The project provides two pieces:

1. A Blender addon – runs inside Blender and opens a local server that can receive commands.
2. An MCP server – a Python program that connects your AI assistant to that Blender server.

How does it work?

• You install the addon in Blender and start the MCP server (usually automatically when Blender opens).
• You configure your AI assistant (Claude Desktop, Codex, Cursor, VS Code, etc.) to use this MCP server.
• When you ask the AI to do something in Blender, the AI sends a command through the MCP server to the Blender addon, which executes it.
• The addon can create, modify, and delete objects, change materials, inspect the scene, and even run arbitrary Python code inside Blender.

Key features

• Two-way communication – the AI can both send commands and read scene information.
• Object manipulation – create, move, scale, delete 3D objects.
• Material control – apply and edit materials and colors.
• Scene inspection – get details about the current Blender scene.
• Code execution – the AI can run Python scripts directly in Blender (with an optional safe mode to block risky operations).
• Asset & model generation – pull in models from Poly Haven, Sketchfab, Poly Pizza, or generate AI 3D models via services like Hyper3D Rodin and Hunyuan3D (premium features may require API keys or a subscription).

Setup

The README provides a one-line installer for macOS/Linux/Windows that sets up everything automatically. Manual setup involves:

1. Installing uv (a Python package manager).
2. Adding the MCP server to your AI client (e.g., Claude Desktop config).
3. Installing the Blender addon via uvx mcp-for-blender install-addon.
4. Enabling the addon in Blender and starting the server.

Security & limitations

• The Blender addon's socket server has no authentication or encryption – anyone who can reach the port can run Python inside Blender. The README strongly recommends keeping it on localhost and using SSH tunnels for remote access.
• By default, the AI can run any Python code in Blender. A safe mode (BLENDER_MCP_SAFE_MODE=1) can be enabled to block risky operations like file access, network calls, or persistent code.
• Only run one instance of the MCP server at a time (e.g., not both Cursor and Claude Desktop).

Summary

MCP for Blender is a practical, actively maintained integration that lets you drive Blender with AI assistants. It's a genuine software project with real functionality, not just a demo or list. The README is thorough, covering installation, configuration, security, and troubleshooting.