CursorTouch / Windows-MCP
git clone https://github.com/CursorTouch/Windows-MCP.git
v0.8.8 · 12d ago
MCP Server for Computer Use in Windows
+52
stars, 24h · #285
+~364
stars, 7 days · #347
+~1.6k
stars, 30 days · #343
9.9k
★ total · +4% this week
1.1k
forks · 32 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2025-05-13 (1y ago)
Last pushtoday
Watchers44
OwnerOrganization
GitHub topics
Links
README excerpt
🪟 Windows-MCP **Windows-MCP** is a lightweight, open-source project that enables seamless integration between AI agents and the Windows operating system. Acting as an MCP server bridges the gap between LLMs and the Windows operating system, allowing agents to perform tasks such as **file navigation, application control, UI interaction, QA testing,** and more. mcp-name: io.github.CursorTouch/Windows-MCP ## Updates - Windows-MCP reached `2M+ Users` in Claude Desktop Extensiosn. - Try out 🪟Windows-Use, an agent built using Windows-MCP. - Windows-MCP is now available on PyPI (thus supports `uvx windows-mcp`) - Windows-MCP is added to MCP Registry ### Supported Operating Systems - Windows 10 - Windows 11 The current package requires Python 3.14+, which supports Windows 10 and newer. Earlier Windows versions are not supported by the current installation. ## 🎥 Demos ## ✨ Key Features - **Seamless Windows Integration** Interacts natively with Windows UI elements, opens apps, controls windows, simulates user input, and more. - **Use Any LLM (Vision Optional)** Unlike many automation tools, Windows-MCP doesn't rely on any traditional computer vision techniques or specific fine-tuned models; it works with any LLMs, reducing complexity and setup time. - **Rich Toolset for UI Automation** Includes tools for basic keyboard, mouse operation and capturing window/UI state. - **Lightweight & Open-Source** Minimal dependencies and easy setup with full source code available under MIT license. - **Customizable & Extendable** Easily adapt or extend tools to suit your unique automation or AI integration needs. - **Real-Time Interaction** Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.2 to 0.5 secs**, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm. - **DOM Mode for Browser Automation** Special `use_dom=True` mode for State-Tool that focuses exclusively on web page content, filtering out browser UI elements for cleaner, more efficient web automation. Supports Chrome, Edge, and Firefox (Firefox uses an IAccessible2 fallback since it doesn't expose `RootWebArea` via UIA). ## 🛠️Installation **Note:** When you install this MCP server for the first time it may take a minute or two because of installing the dependencies in `pyproject.toml`. In the first run the server may timeout ignore it and restart it. ### Prerequisites - Python 3.14+ - UV (Package Manager) from Astra, install with `pip install uv` or `curl -LsSf https://astral.sh/uv/install.sh | sh` - The `App` tool resolves localized Start Menu display names as well as internal app names; an English Windows display language is not required. ### Run at Login Run the server directly when needed: [code] Install it as a background task that starts now and at every login: [code] This creates a per-user Scheduled Task named `windows-mcp-server` and a wrapper script at `~/.windows-mcp/start-server