BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:846-877 (handler)

  The import_generated_asset tool is defined and registered in src/blender_mcp/server.py using the @mcp.tool() decorator. It handles the import of generated assets by sending a command to a Blender connection.

  @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)}"