qt-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_windowsA | List all visible top-level X11 windows with id, title, and geometry. Use this first to discover the exact window title you need for capture_window or capture_region. Each entry has: id, title, desktop, x, y, width, height. |
| capture_windowA | Capture an entire window identified by its title (case-insensitive substring match). Args: title: Window title or substring of it (case-insensitive). Use list_windows to find candidates. When multiple windows match, the call fails and lists the matching titles — provide a more specific substring or set exact=True. exact: If True, match the title exactly (case-sensitive). Returns the screenshot as a PNG image. The window's geometry is logged but not returned alongside the image (call list_windows for geometry details). |
| capture_regionA | Capture a rectangular screen region as a PNG image. Args:
x: Top-left X. Absolute screen coordinate, or relative to the window
identified by Returns the region as a PNG image. |
| read_fileA | Read a text file. Returns up to Args:
path: File path (absolute, or relative to the server's working dir). Returns: path, content, total_lines, returned_lines, offset, truncated. |
| write_fileA | Write or append text to a file. Args:
path: Destination file path. Returns: path, bytes_written, appended. |
| list_directoryA | List entries in a directory. Args:
path: Directory path (default: current directory). Returns: path, entries (name/path/type/size), count. |
| create_directoryA | Create a directory. Args:
path: Directory path to create. Returns: path, created, exists. |
| moveA | Move or rename a file or directory. Args: path: Source path. destination: Destination path. overwrite: Overwrite destination if it exists (default False; errors otherwise). Returns: source, destination, moved. |
| deleteA | Delete a file or directory. Args: path: Path to delete. Symlinks are unlinked (their targets are preserved). recursive: Required True to delete a directory tree. Files are deleted regardless of this flag. Returns: path, deleted. |
| file_infoC | Return metadata for a file, directory, or symlink. Returns: path, type, size, modified (ISO-8601 UTC), is_symlink, permissions. |
| search_globA | Find files matching a glob pattern (recursive). Args:
path: Directory to search in (default current dir).
pattern: Glob pattern, e.g. Returns: path, pattern, matches, count, truncated. |
| search_contentA | Search file contents for a regex pattern (recursive). Args:
path: Directory (or single file) to search.
pattern: Regex pattern to search for (required).
include_hidden: Include dotfiles (default False).
file_glob: Only search files matching this glob (default Returns: path, pattern, file_glob, matches, count, files_scanned, truncated. |
| capture_widgetA | Capture a specific Qt widget by its objectName via the proxy agent. Requires a Qt application that has called Args:
widget_name: The widget's Returns the widget as a PNG image. |
| list_capturable_widgetsA | List the objectNames of widgets in the attached Qt app. Requires a Qt application that has called Returns: |
| attach_statusA | Check whether a Qt app is currently attached via the proxy agent. Always works, no error. Useful for clients to poll. Returns: |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Each tool has a clearly distinct purpose: file operations (move, create_directory, read_file, write_file, etc.) are separate from screen capture tools (list_windows, capture_window, capture_region) and Qt widget tools (capture_widget, list_capturable_widgets, attach_status). There is no overlap or ambiguity between tools.
Most tool names follow a verb_noun pattern (e.g., create_directory, list_windows, read_file). However, a few deviate: 'delete' is a single verb, and 'file_info' is noun_noun. Overall the pattern is mostly consistent and intuitive.
15 tools is slightly above the typical range but still well-scoped for the server's three domains (file management, screen capture, Qt widget capture). The count is justified and not excessive.
File operations cover create, read, update, delete, list, search, and move—nearly complete lifecycle. Screen capture tools provide listing and capture. Qt widget tools offer listing and capture but lack interaction beyond capture, which is acceptable given the server's focus.