create_object
Add 3D objects to Blender scenes by specifying type, location, rotation, and scale parameters for scene composition.
Instructions
Create a new object in the Blender scene.
Parameters:
- type: Object type (CUBE, SPHERE, CYLINDER, PLANE, CONE, TORUS, EMPTY, CAMERA, LIGHT)
- name: Optional name for the object
- location: Optional [x, y, z] location coordinates
- rotation: Optional [x, y, z] rotation in radians
- scale: Optional [x, y, z] scale factorsInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | CUBE | |
| name | No | ||
| location | No | ||
| rotation | No | ||
| scale | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/server.py:318-356 (handler)The main handler function for the 'create_object' MCP tool. It is decorated with @mcp.tool() for automatic registration. The function constructs parameters from inputs, sends a 'create_object' command to the Blender addon via socket, and returns a success message with the created object's name.
@mcp.tool() def create_object( ctx: Context, type: str = "CUBE", name: str = None, location: List[float] = None, rotation: List[float] = None, scale: List[float] = None, ) -> str: """ Create a new object in the Blender scene. Parameters: - type: Object type (CUBE, SPHERE, CYLINDER, PLANE, CONE, TORUS, EMPTY, CAMERA, LIGHT) - name: Optional name for the object - location: Optional [x, y, z] location coordinates - rotation: Optional [x, y, z] rotation in radians - scale: Optional [x, y, z] scale factors """ try: # Get the global connection blender = get_blender_connection() # Set default values for missing parameters loc = location or [0, 0, 0] rot = rotation or [0, 0, 0] sc = scale or [1, 1, 1] params = {"type": type, "location": loc, "rotation": rot, "scale": sc} if name: params["name"] = name result = blender.send_command("create_object", params) return f"Created {type} object: {result['name']}" except Exception as e: logger.error(f"Error creating object: {str(e)}") return f"Error creating object: {str(e)}" - src/server.py:327-336 (schema)The docstring provides detailed input schema/parameter descriptions for the create_object tool, specifying types, defaults, and valid values (e.g., primitive types).
""" Create a new object in the Blender scene. Parameters: - type: Object type (CUBE, SPHERE, CYLINDER, PLANE, CONE, TORUS, EMPTY, CAMERA, LIGHT) - name: Optional name for the object - location: Optional [x, y, z] location coordinates - rotation: Optional [x, y, z] rotation in radians - scale: Optional [x, y, z] scale factors """ - src/server.py:318-318 (registration)The @mcp.tool() decorator registers the create_object function as an MCP tool.
@mcp.tool() - src/server.py:707-707 (helper)Reference to create_object in the asset_creation_strategy prompt, guiding when to use it.
- create_object() for basic primitives (CUBE, SPHERE, CYLINDER, etc.)