BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:841-873 (handler)

  The primary handler function for the MCP tool 'import_generated_asset'. It is registered via @mcp.tool() decorator, defines input parameters (name, task_uuid or request_id), and proxies the import request to the Blender addon via send_command, handling errors.

  @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:896-920 (helper)

  Supporting documentation in the asset_creation_strategy prompt that describes the usage of import_generated_asset as the final step in the Hyper3D Rodin model generation workflow.

  Hyper3D Rodin is good at generating 3D models for single item.
  So don't try to:
  1. Generate the whole scene with one shot
  2. Generate ground using Hyper3D
  3. Generate parts of the items separately and put them together afterwards
  
  Use get_hyper3d_status() to verify its status
  If Hyper3D is enabled:
  - For objects/models, do the following steps:
      1. Create the model generation task
          - Use generate_hyper3d_model_via_images() if image(s) is/are given
          - Use generate_hyper3d_model_via_text() if generating 3D asset using text prompt
          If key type is free_trial and insufficient balance error returned, tell the user that the free trial key can only generated limited models everyday, they can choose to:
          - Wait for another day and try again
          - Go to hyper3d.ai to find out how to get their own API key
          - Go to fal.ai to get their own private API key
      2. Poll the status
          - Use poll_rodin_job_status() to check if the generation task has completed or failed
      3. Import the asset
          - Use import_generated_asset() to import the generated GLB model the asset
      4. After importing the asset, ALWAYS check the world_bounding_box of the imported mesh, and adjust the mesh's location and size
          Adjust the imported mesh's location, scale, rotation, so that the mesh is on the right spot.
  
      You can reuse assets previous generated by running python code to duplicate the object, without creating another generation task.

• src/blender_mcp/server.py:841-841 (registration)

  The @mcp.tool() decorator registers the import_generated_asset function as an MCP tool.

  @mcp.tool()