BlenderMCP x CSM.ai x LLM Agents (e.g. Cursor / Claude)

Connect Blender, CSM.ai and LLMs via the Model Context Protocol (MCP). This integration enables text and image based editing capabilities in Blender.

      ╭───────────╮       ╭───────────╮       ╭───────────╮
      │  CSM.ai   │◄━━━━━►│  Blender  │◄━━━━━►│  MCP UI   │
      │ 3D Assets │       │    MCP    │       │e.g.Cursor │
      ╰─────┬─────╯       ╰─────┬─────╯       ╰─────┬─────╯
            │                   │                   │
            ▼                   ▼                   ▼
      ╭─────────────────────────────────────────────────╮
      │                                                 │
      │               BLENDER ENGINE                    │
      │        Creative 3D Modeling Environment         │
      │                                                 │
      ╰─────────────────────────────────────────────────╯

https://github.com/user-attachments/assets/496c2c69-4779-4569-9be0-80b767702c4c

Overview

BlenderMCP creates a bridge between Blender, CSM.ai and language models, allowing for powerful AI-assisted 3D modeling workflows.

MCP Feature List ✨

• 🔍 Ability to quickly search from public or private CSM.ai sessions. This allows interactive MCP based development. E.g. “Use CSM to get me a ghibli robot”. Make sure you have some pre-generated robots on 3d.csm.ai or it will use some public session.

• 🏃 For any humanoid like mesh in the scene, ability to animate given a text prompt (from a fixed library set). E.g. “use csm to animate the ‘robot’ mesh to dance”. This assumes the name of the object is ‘robot’. To do subsequent animations, clear the space and make sure the original object is replicated (script should do this automatically).

Installation

1. Clone the repository:

   git clone https://github.com/CommonSenseMachines/blender-mcp.git
   

2. Navigate to the project directory:

   cd blender-mcp
   

3. Install the package:

   pip install -e .
   

Troubleshooting

• Upgrade pip
• Use python3.10 -m pip install -e . if you don’t normally use python

Cursor Configuration

1. Open Cursor in the root directory of the cloned blender-mcp repo.
2. Navigate to: Cursor → Settings → Cursor Settings → MCP → Add a new server
3. Add the following MCP configuration (see .mcp.json file):

{
    "mcpServers": {
        "blender": {
            "command": "python",
            "args": [
                "-m", "blender_mcp.server"
            ]
        }
    }
}

Troubleshooting

• Use Cursor from the blender-mcp directory
• Use python3.10 in mcp.json (or whatever your normal Blender Python version is)

Blender Configuration

1. Launch Blender
2. Navigate to Edit → Preferences
3. Install the addon.py file from this repository