download_sketchfab_model
Download and import Sketchfab 3D models into Blender with automatic scaling to specified dimensions for accurate scene integration.
Instructions
Download and import a Sketchfab model by its UID. The model will be scaled so its largest dimension equals target_size.
Parameters:
uid: The unique identifier of the Sketchfab model
target_size: REQUIRED. The target size in Blender units/meters for the largest dimension. You must specify the desired size for the model. Examples: - Chair: target_size=1.0 (1 meter tall) - Table: target_size=0.75 (75cm tall) - Car: target_size=4.5 (4.5 meters long) - Person: target_size=1.7 (1.7 meters tall) - Small object (cup, phone): target_size=0.1 to 0.3
Returns a message with import details including object names, dimensions, and bounding box. The model must be downloadable and you must have proper access rights.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | ||
| target_size | Yes |
Implementation Reference
- src/blender_mcp/server.py:636-672 (handler)The `download_sketchfab_model` function acts as the MCP tool handler. It is registered via `@mcp.tool()` and communicates with Blender via `blender.send_command`.
@mcp.tool() def download_sketchfab_model( ctx: Context, uid: str, target_size: float ) -> str: """ Download and import a Sketchfab model by its UID. The model will be scaled so its largest dimension equals target_size. Parameters: - uid: The unique identifier of the Sketchfab model - target_size: REQUIRED. The target size in Blender units/meters for the largest dimension. You must specify the desired size for the model. Examples: - Chair: target_size=1.0 (1 meter tall) - Table: target_size=0.75 (75cm tall) - Car: target_size=4.5 (4.5 meters long) - Person: target_size=1.7 (1.7 meters tall) - Small object (cup, phone): target_size=0.1 to 0.3 Returns a message with import details including object names, dimensions, and bounding box. The model must be downloadable and you must have proper access rights. """ try: blender = get_blender_connection() logger.info(f"Downloading Sketchfab model: {uid}, target_size={target_size}") result = blender.send_command("download_sketchfab_model", { "uid": uid, "normalize_size": True, # Always normalize "target_size": target_size }) if result is None: logger.error("Received None result from Sketchfab download") return "Error: Received no response from Sketchfab download request"