download_sketchfab_model
Import 3D models from Sketchfab into Blender using the model's unique identifier. This tool fetches downloadable models with proper access rights for use in 3D scenes.
Instructions
Download and import a Sketchfab model by its UID.
Parameters:
- uid: The unique identifier of the Sketchfab model
Returns a message indicating success or failure.
The model must be downloadable and you must have proper access rights.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes |
Implementation Reference
- src/blender_mcp/server.py:659-701 (handler)The main handler function for the 'download_sketchfab_model' MCP tool. It connects to the Blender addon via socket and forwards the download request with the model UID, handling the response and errors.@mcp.tool() def download_sketchfab_model( ctx: Context, uid: str ) -> str: """ Download and import a Sketchfab model by its UID. Parameters: - uid: The unique identifier of the Sketchfab model Returns a message indicating success or failure. The model must be downloadable and you must have proper access rights. """ try: blender = get_blender_connection() logger.info(f"Attempting to download Sketchfab model with UID: {uid}") result = blender.send_command("download_sketchfab_model", { "uid": uid }) if result is None: logger.error("Received None result from Sketchfab download") return "Error: Received no response from Sketchfab download request" if "error" in result: logger.error(f"Error from Sketchfab download: {result['error']}") return f"Error: {result['error']}" if result.get("success"): imported_objects = result.get("imported_objects", []) object_names = ", ".join(imported_objects) if imported_objects else "none" return f"Successfully imported model. Created objects: {object_names}" else: return f"Failed to download model: {result.get('message', 'Unknown error')}" except Exception as e: logger.error(f"Error downloading Sketchfab model: {str(e)}") import traceback logger.error(traceback.format_exc()) return f"Error downloading Sketchfab model: {str(e)}"
- src/blender_mcp/server.py:659-659 (registration)The @mcp.tool() decorator registers the download_sketchfab_model function as an MCP tool.@mcp.tool()
- src/blender_mcp/server.py:660-672 (schema)Input schema defined by function parameters (uid: str) and output str, with detailed docstring describing usage.def download_sketchfab_model( ctx: Context, uid: str ) -> str: """ Download and import a Sketchfab model by its UID. Parameters: - uid: The unique identifier of the Sketchfab model Returns a message indicating success or failure. The model must be downloadable and you must have proper access rights. """
- src/blender_mcp/server.py:897-898 (helper)Documentation in the asset_creation_strategy prompt explaining usage of the tool.- Then download specific models using download_sketchfab_model() with the UID - Note that only downloadable models can be accessed, and API key must be properly configured