Back to Home
huegli icon

win-ctrl-mcp

Verified Safe

by huegli

Overview

Provides an MCP server to enable LLMs to control the AeroSpace window manager on macOS for window organization, smart focus, and GUI debugging.

Installation

Run Command
uv run win-ctrl-mcp

Security Notes

The server executes external macOS commands (`aerospace`, `screencapture`) via subprocesses. While arguments passed to these commands are mostly controlled (e.g., numerical IDs are cast to strings), string arguments like `output_path` for capture tools could potentially allow an instructed LLM to specify malicious file paths for overwriting. However, `subprocess.run` and `asyncio.create_subprocess_exec` are used without `shell=True`, mitigating shell injection for direct arguments. It is primarily designed for a local, single-user desktop environment, reducing external attack vectors. No `eval` or obvious hardcoded secrets were found.

Similar Servers

Stats

Interest Score0
Security Score8
Cost ClassMedium
Avg Tokens500
Stars0
Forks0
Last Update2025-11-29

Tags

window managementmacosaerospaceproductivityautomationgui debugging