Blender MCP Server

3D modeling and animation capabilities through Blender integration for creating and manipulating 3D content.

3D Modeling 3DModelingAnimation

Configuration

MCP Settings Configuration

{
  "blender": {
    "stdio": {
      "command": "python3",
      "args": [
        "-m", "mcpuniverse.mcp.servers.blender"
      ]
    }
  }
}

Source Code

View Source Code

Browse the implementation on GitHub

Available Tools & Methods

get_scene_info()

Get detailed information about the current Blender scene

Parameters: None

clear_scene_and_polyhaven_materials()

Clear the current Blender scene and remove all PolyHaven materials

Parameters: None

get_object_info(object_name)

Get detailed information about a specific object in the Blender scene

Parameters: object_name (string) - The name of the object to get information about

create_object(type, name, location, rotation, scale, ...)

Create a new object in the Blender scene

Parameters: type (string), name (string, optional), location (array, optional), rotation (array, optional), scale (array, optional)

Object types: CUBE, SPHERE, CYLINDER, PLANE, CONE, TORUS, EMPTY, CAMERA, LIGHT
Torus-specific parameters: align, major_segments, minor_segments, mode, major_radius, minor_radius, etc.

modify_object(name, location, rotation, scale, visible)

Modify an existing object in the Blender scene

Parameters: name (string), location (array, optional), rotation (array, optional), scale (array, optional), visible (boolean, optional)

delete_object(name)

Delete an object from the Blender scene

Parameters: name (string) - Name of the object to delete

set_material(object_name, material_name, color)

Set or create a material for an object

Parameters: object_name (string), material_name (string, optional), color (array, optional) - RGB values (0.0-1.0)

set_texture(object_name, texture_id)

Apply a previously downloaded Polyhaven texture to an object

Parameters: object_name (string), texture_id (string) - ID of the Polyhaven texture (must be downloaded first)

execute_blender_code(code)

Execute arbitrary Python code in Blender

Parameters: code (string) - The Python code to execute

get_polyhaven_status()

Check if PolyHaven integration is enabled in Blender

Parameters: None

get_polyhaven_categories(asset_type)

Get a list of categories for a specific asset type on Polyhaven

Parameters: asset_type (string, optional, default: "hdris") - Asset type (hdris, textures, models, all)

search_polyhaven_assets(asset_type, categories)

Search for assets on Polyhaven with optional filtering

Parameters: asset_type (string, optional, default: "all"), categories (string, optional) - Comma-separated list of categories

download_polyhaven_asset(asset_id, asset_type, resolution, file_format)

Download and import a Polyhaven asset into Blender

Parameters: asset_id (string), asset_type (string), resolution (string, optional, default: "1k"), file_format (string, optional)

Asset types: hdris, textures, models
Resolutions: 1k, 2k, 4k
File formats: hdr/exr (HDRIs), jpg/png (textures), gltf/fbx (models)

Installation Guide

# Installation Please follow the setup guide: https://github.com/SalesforceAIResearch/MCP-Universe/blob/main/docs/blender-setup.md