Bonsai-mcp

Instructions

Creates a drawing, with the view type specified, of the IFC building at the specified 
height above the floor level. Supports custom resolution for high-quality architectural drawings.

Args:
    height_offset: Height in meters above the storey level for the camera position (default 0.5m)
    view_type: Type of view - "top" for plan view, "front", "right" and "left" for elevation views, and "isometric" for 3D view
    resolution_x: Horizontal resolution in pixels (default 1920, max recommended 4096)
    resolution_y: Vertical resolution in pixels (default 1080, max recommended 4096)
    storey_name: Specific storey name to add to the file name (if None, prints default in the file name)
    output_path: Optional file path to save the PNG (if None, returns as base64 image)

Returns:
    metadata and the path of the file image of the drawing at the specified resolution

Implementation Reference

• tools.py:741-825 (handler)

  The handler function for the 'export_drawing_png' MCP tool. It validates input parameters, connects to Blender via the global connection, sends an 'export_drawing_png' command with parameters to the Blender addon, receives base64-encoded PNG image data, decodes it, generates a filename if not provided, saves the image to ./exports/drawings/, and returns a dictionary with status and absolute file path.

  @mcp.tool()
  def export_drawing_png(
      height_offset: float = 0.5,
      view_type: str = "top",
      resolution_x: int = 1920,
      resolution_y: int = 1080,
      storey_name: str | None = None,
      output_path: str | None = None
  ) -> dict:
      """Export drawings as PNG images with custom resolution.
      
      Creates a drawing, with the view type specified, of the IFC building at the specified 
      height above the floor level. Supports custom resolution for high-quality architectural drawings.
      
      Args:
          height_offset: Height in meters above the storey level for the camera position (default 0.5m)
          view_type: Type of view - "top" for plan view, "front", "right" and "left" for elevation views, and "isometric" for 3D view
          resolution_x: Horizontal resolution in pixels (default 1920, max recommended 4096)
          resolution_y: Vertical resolution in pixels (default 1080, max recommended 4096)
          storey_name: Specific storey name to add to the file name (if None, prints default in the file name)
          output_path: Optional file path to save the PNG (if None, returns as base64 image)
      
      Returns:
          metadata and the path of the file image of the drawing at the specified resolution
      """
      try:
          # Validate resolution limits for performance
          if resolution_x > 4096 or resolution_y > 4096:
              raise Exception("Resolution too high. Maximum recommended: 4096x4096 pixels")
          
          if resolution_x < 100 or resolution_y < 100:
              raise Exception("Resolution too low. Minimum: 100x100 pixels")
          
          # Get the global connection
          blender = get_blender_connection()
          
          # Request drawing render
          result = blender.send_command("export_drawing_png", {
              "view_type": view_type,
              "height_offset": height_offset,
              "resolution_x": resolution_x,
              "resolution_y": resolution_y,
              "storey_name": storey_name,
              "output_path": output_path
          })
          
          if "error" in result:
              raise Exception(f"Error creating {view_type} drawing: {result.get('error', 'Unknown error')}")
          
          if "data" not in result:
              raise Exception("No image data returned from Blender")
          
          # Decode the base64 image data
          image_data = base64.b64decode(result["data"])
          
          # Ensure output path exists
          if not output_path:
              os.makedirs("./exports/drawings", exist_ok=True)
              # Generate filename based on view type
              view_name = {
                  "top": "plan_view",
                  "front": "front_elevation", 
                  "right": "right_elevation",
                  "left": "left_elevation",
                  "isometric": "isometric_view"
              }.get(view_type, view_type)
              filename = f"{view_name}_{storey_name or 'default'}.png"
              output_path = os.path.join("./exports/drawings", filename)
          
          # Save to file
          with open(output_path, "wb") as f:
              f.write(image_data)
          
          # Return only metadata
          return {
              "status": "success",
              "file_path": os.path.abspath(output_path),
              # Opcional: si tienes un servidor de archivos, podrías devolver también una URL
              # "url": f"http://localhost:8000/files/{filename}"
          }
          
      except Exception as e:
          logger.error(f"Error exporting drawing: {str(e)}")
          return { "status": "error", "message": str(e) }