qt-mcp

Args:
    ref: Widget ref from qt_snapshot (e.g., 'w5'). If omitted, captures active window.
    full_window: If True, captures the first visible top-level window.
    max_width: Max width before downscaling (default 1920).
    max_height: Max height before downscaling (default 1080).
    format: Image format - 'png' or 'jpeg' (default 'png').
    quality: JPEG quality 1-100 (default 80, ignored for PNG).

Returns a base64-encoded PNG image.

Args:
    ref: Widget ref from qt_snapshot (e.g., 'w5').

Returns all Qt properties, geometry, parent chain, and more.

Args:
    ref: Widget ref from qt_snapshot.
    button: Mouse button - 'left', 'right', or 'middle'.
    modifiers: Keyboard modifiers - 'shift', 'ctrl', 'alt', 'meta'.
    position: [x, y] relative to widget top-left. Default: center.

Args:
    ref: Widget ref from qt_snapshot.
    text: Text to type.
    clear_first: If True, select all and delete before typing.

Args:
    key: Key name (e.g., 'Return', 'Escape', 'Ctrl+S', 'a').
    ref: Widget ref. If omitted, sends to the currently focused widget.

Args:
    ref: Widget ref from qt_snapshot.
    property_name: Qt property name.
    value: New value for the property.

Args:
    ref: Widget ref from qt_snapshot.
    method_name: Slot/method name to invoke.

Args:
    ref: Widget ref from qt_snapshot (e.g., 'w5').

Works with QPlainTextEdit, QTextEdit, QLineEdit, QLabel, QComboBox,
and any widget with a text() or toPlainText() method.

Args:
    ref: Ref to a QMenu, QMenuBar, QToolBar, or any widget with actions.
    action_text: The action's display text (e.g., 'Save', '&Open').
        Ampersands are stripped for matching.
    action_index: The 0-based index of the action
        (matching qt_menu_items order).

Provide either action_text or action_index (not both).
Use qt_menu_items first to see available actions.

Args:
    condition: One of 'widget_visible', 'window_count_changed', 'property_equals'.
    timeout_ms: Max time to wait in milliseconds (default 5000).
    object_name: Widget objectName (for widget_visible).
    ref: Widget ref (for property_equals).
    property_name: Property name (for property_equals).
    value: Expected value (for property_equals).

Args:
    root_ref: Starting ref. Defaults to QApplication root.
    max_depth: Maximum traversal depth.

Args:
    ref: Ref to a QMenu widget.

Args:
    level: Level of the console messages to return. Each level includes the messages
        of more severe levels. Defaults to "info".

For a given widget/object, enumerates all signals and reports which are
connected and how many receivers each has. Useful for debugging "nothing
happens when I click" problems.

Args:
    ref: Widget ref from qt_snapshot (e.g., 'w5').

Scans all visible widgets and reports problems like:
- zero_size: Visible widget with 0x0 geometry (collapsed)
- no_layout: Container with visible children but no layout manager
- smaller_than_hint: Widget smaller than its sizeHint (content likely clipped)
- text_truncated: Text content wider than widget width
- overlapping_siblings: Sibling widgets with intersecting geometries

Args:
    ref: Ref to a QGraphicsView widget.

Args:
    ref: Ref to a widget containing a VTK render window.

Args:
    ref: Ref to a widget containing a VTK render window.