Skip to main content

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
  • Automatically releases modifier keys before typing to prevent stuck-shift issues
  • Global PyAutoGUI defaults tuned for automation (PAUSE, FAILSAFE)

Configuration

  • Set REALTIMEX_FAILSAFE to 0 or 1 (default 1) to control PyAutoGUI’s failsafe corner abort.
  • Set REALTIMEX_PAUSE to a float (seconds) to override the global pause between PyAutoGUI actions (default 0.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

Metadata

Release files for realtimex-pyautogui-server 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for realtimex-pyautogui-server 0.1.4
File Size Uploaded
realtimex_pyautogui_server-0.1.4.tar.gz 97.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for realtimex-pyautogui-server 0.1.4
File Interpreter ABI Platform
realtimex_pyautogui_server-0.1.4-py3-none-any.whl Python 3 none any Details

Total release size: 102.8 kB

Release files / realtimex_pyautogui_server-0.1.4.tar.gz

Download URL realtimex_pyautogui_server-0.1.4.tar.gz
Size 97.2 kB
Tags Source
SHA-256 checksum
How to use checksums
7b5d33046f18e39c4bed2fd9e2a004159cbb172711a57cdc5c36eec832580326
BLAKE2b-256 checksum
How to use checksums
c847e325663696d4d142e0fc111a0337424c71c3423cf139a20554eb183b6738
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.16

Release files / realtimex_pyautogui_server-0.1.4-py3-none-any.whl

Download URL realtimex_pyautogui_server-0.1.4-py3-none-any.whl
Size 5.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a90b4d7ee2230a7aff2e8c51cffaf1ec8e925600cf6af4c6b54f3a7e0d9039cb
BLAKE2b-256 checksum
How to use checksums
67c95ea9b84a4d247be02a2eb0f697edc049dbf572be9bb64e92788d5df0c4f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.16
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page