# 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
```bash
uvx realtimex-pyautogui-server
```
The server communicates over stdio and is compatible with MCP clients like Claude Desktop and the MCP Inspector.
## Development
```bash
uv sync
uv run ruff check
uv run pytest
```
Raw data
{
"_id": null,
"home_page": null,
"name": "realtimex-pyautogui-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "automation, gui, mcp, pyautogui, realtimex",
"author": "RealTimeX",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c8/47/e325663696d4d142e0fc111a0337424c71c3423cf139a20554eb183b6738/realtimex_pyautogui_server-0.1.4.tar.gz",
"platform": null,
"description": "# realtimex-pyautogui-server\n\nRealTimeX\u2019s 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.\n\n## Features\n- Mouse movement, clicks, and drag support\n- Keyboard typing and hotkeys\n- Screen size, pixel, and screenshot utilities\n- **Dedicated `wait(seconds)` tool** for precise pauses without injecting keystrokes\n- Automatically releases modifier keys before typing to prevent stuck-shift issues\n- Global PyAutoGUI defaults tuned for automation (`PAUSE`, `FAILSAFE`)\n\n## Configuration\n- Set `REALTIMEX_FAILSAFE` to `0` or `1` (default `1`) to control PyAutoGUI\u2019s failsafe corner abort.\n- Set `REALTIMEX_PAUSE` to a float (seconds) to override the global pause between PyAutoGUI actions (default `0.3`).\n\n## Usage\n```bash\nuvx realtimex-pyautogui-server\n```\n\nThe server communicates over stdio and is compatible with MCP clients like Claude Desktop and the MCP Inspector.\n\n## Development\n```bash\nuv sync\nuv run ruff check\nuv run pytest\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "RealTimeX MCP server for deterministic GUI control via PyAutoGUI",
"version": "0.1.4",
"project_urls": null,
"split_keywords": [
"automation",
" gui",
" mcp",
" pyautogui",
" realtimex"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "67c95ea9b84a4d247be02a2eb0f697edc049dbf572be9bb64e92788d5df0c4f8",
"md5": "ca063bd82bafb00e32bf01d9bbe7d487",
"sha256": "a90b4d7ee2230a7aff2e8c51cffaf1ec8e925600cf6af4c6b54f3a7e0d9039cb"
},
"downloads": -1,
"filename": "realtimex_pyautogui_server-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ca063bd82bafb00e32bf01d9bbe7d487",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 5629,
"upload_time": "2025-11-06T09:55:37",
"upload_time_iso_8601": "2025-11-06T09:55:37.692646Z",
"url": "https://files.pythonhosted.org/packages/67/c9/5ea9b84a4d247be02a2eb0f697edc049dbf572be9bb64e92788d5df0c4f8/realtimex_pyautogui_server-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c847e325663696d4d142e0fc111a0337424c71c3423cf139a20554eb183b6738",
"md5": "efdc8cef8cd3472a0768b8dcea9553e7",
"sha256": "7b5d33046f18e39c4bed2fd9e2a004159cbb172711a57cdc5c36eec832580326"
},
"downloads": -1,
"filename": "realtimex_pyautogui_server-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "efdc8cef8cd3472a0768b8dcea9553e7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 97199,
"upload_time": "2025-11-06T09:55:39",
"upload_time_iso_8601": "2025-11-06T09:55:39.654492Z",
"url": "https://files.pythonhosted.org/packages/c8/47/e325663696d4d142e0fc111a0337424c71c3423cf139a20554eb183b6738/realtimex_pyautogui_server-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-06 09:55:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "realtimex-pyautogui-server"
}
JSON