BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:654-696 (handler)

  MCP tool handler for downloading and importing Sketchfab models by UID. Forwards the request to the Blender addon via socket send_command and handles the response, logging errors and returning success/failure messages.

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