BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:287-315 (handler)

  The handler function 'get_viewport_screenshot' that captures a viewport screenshot in Blender. It wraps a call to 'blender.send_command'.

  @telemetry_tool("get_viewport_screenshot")
  @mcp.tool()
  def get_viewport_screenshot(ctx: Context, max_size: int = 800) -> Image:
      """
      Capture a screenshot of the current Blender 3D viewport.
      
      Parameters:
      - max_size: Maximum size in pixels for the largest dimension (default: 800)
      
      Returns the screenshot as an Image.
      """
      try:
          blender = get_blender_connection()
          
          # Create temp file path
          temp_dir = tempfile.gettempdir()
          temp_path = os.path.join(temp_dir, f"blender_screenshot_{os.getpid()}.png")
          
          result = blender.send_command("get_viewport_screenshot", {
              "max_size": max_size,
              "filepath": temp_path,
              "format": "png"
          })
          
          if "error" in result:
              raise Exception(result["error"])
          
          if not os.path.exists(temp_path):
              raise Exception("Screenshot file was not created")