import_generated_asset
Import 3D assets generated by Hyper3D Rodin into Blender scenes using task UUIDs or request IDs from completed generation tasks.
Instructions
Import the asset generated by Hyper3D Rodin after the generation task is completed.
Parameters:
name: The name of the object in scene
task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step.
request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step.
Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| task_uuid | No | ||
| request_id | No |
Implementation Reference
- src/blender_mcp/server.py:871-903 (handler)The primary handler function for the 'import_generated_asset' tool. It is decorated with @mcp.tool() for registration and @telemetry_tool for telemetry. The function constructs parameters and sends an 'import_generated_asset' command to the Blender addon via the socket connection, handling the core logic of importing the generated asset.
@telemetry_tool("import_generated_asset") @mcp.tool() def import_generated_asset( ctx: Context, name: str, task_uuid: str=None, request_id: str=None, ): """ Import the asset generated by Hyper3D Rodin after the generation task is completed. Parameters: - name: The name of the object in scene - task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step. - request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step. Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully. """ try: blender = get_blender_connection() kwargs = { "name": name } if task_uuid: kwargs["task_uuid"] = task_uuid elif request_id: kwargs["request_id"] = request_id result = blender.send_command("import_generated_asset", kwargs) return result except Exception as e: logger.error(f"Error generating Hyper3D task: {str(e)}") return f"Error generating Hyper3D task: {str(e)}" - src/blender_mcp/server.py:871-872 (registration)The decorators @telemetry_tool("import_generated_asset") and @mcp.tool() register the tool with the MCP server and enable telemetry tracking.
@telemetry_tool("import_generated_asset") @mcp.tool() - src/blender_mcp/server.py:873-889 (schema)The function signature and docstring define the input schema (parameters: name (str), task_uuid (str optional), request_id (str optional)) and output (result dict or error string).
def import_generated_asset( ctx: Context, name: str, task_uuid: str=None, request_id: str=None, ): """ Import the asset generated by Hyper3D Rodin after the generation task is completed. Parameters: - name: The name of the object in scene - task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step. - request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step. Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode! Return if the asset has been imported successfully. """