BlenderMCP

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.

Implementation Reference

• src/blender_mcp/server.py:659-701 (handler)

  The primary handler for the download_sketchfab_model MCP tool. It uses the BlenderConnection to send a 'download_sketchfab_model' command to the Blender addon with the provided UID, handles the response, and returns success/failure message with imported object names.

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