BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:680-705 (handler)

  The handler for the get_sketchfab_model_preview tool, which communicates with Blender via send_command to retrieve a thumbnail.

  @telemetry_tool("download_sketchfab_model")
  @mcp.tool()
  def get_sketchfab_model_preview(
      ctx: Context,
      uid: str
  ) -> Image:
      """
      Get a preview thumbnail of a Sketchfab model by its UID.
      Use this to visually confirm a model before downloading.
      
      Parameters:
      - uid: The unique identifier of the Sketchfab model (obtained from search_sketchfab_models)
      
      Returns the model's thumbnail as an Image for visual confirmation.
      """
      try:
          blender = get_blender_connection()
          logger.info(f"Getting Sketchfab model preview for UID: {uid}")
          
          result = blender.send_command("get_sketchfab_model_preview", {"uid": uid})
          
          if result is None:
              raise Exception("Received no response from Blender")
          
          if "error" in result:
              raise Exception(result["error"])