RealTimeX MCP server for deterministic GUI control via PyAutoGUI
Project description
realtimex-pyautogui-server
RealTimeX’s MCP server for deterministic desktop control with PyAutoGUI. This fork adapts the reference implementation with production defaults, a dedicated wait tool, and safeguards that prevent accidental keystrokes during pauses.
Features
- Mouse movement, clicks, and drag support
- Keyboard typing and hotkeys
- Screen size, pixel, and screenshot utilities
- Dedicated
wait(seconds)tool for precise pauses without injecting keystrokes - Global PyAutoGUI defaults tuned for automation (
PAUSE,FAILSAFE)
Configuration
- Set
REALTIMEX_FAILSAFEto0or1(default1) to control PyAutoGUI’s failsafe corner abort. - Set
REALTIMEX_PAUSEto a float (seconds) to override the global pause between PyAutoGUI actions (default0.3).
Usage
uvx realtimex-pyautogui-server
The server communicates over stdio and is compatible with MCP clients like Claude Desktop and the MCP Inspector.
Development
uv sync
uv run ruff check
uv run pytest
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file realtimex_pyautogui_server-0.1.0.tar.gz.
File metadata
- Download URL: realtimex_pyautogui_server-0.1.0.tar.gz
- Upload date:
- Size: 96.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.7.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e3c02800dca2bacebd2f9f06cd0466855c0db05a3f0aee260b9cf53921ef84f0
|
|
| MD5 |
ad6f661ef08fd4bc2389b0c2a490c14d
|
|
| BLAKE2b-256 |
6816250150cda205a19b2ddfb4403ae83bbaf06b86e245a204f112311c54781a
|
File details
Details for the file realtimex_pyautogui_server-0.1.0-py3-none-any.whl.
File metadata
- Download URL: realtimex_pyautogui_server-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.7.16
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
537a8d265c9aed87b419fbfbeea33f27c635f94c8d0e6b5d50b757625ab78b65
|
|
| MD5 |
389638aebb845b5649d919591259cfc2
|
|
| BLAKE2b-256 |
84f0c2f07124bb57cd36e4be8667a71e9da2fc2a1051939e6bc074981961917e
|
