windows-mcp 0.5.7__py3-none-any.whl → 0.5.9__py3-none-any.whl

windows_mcp/watchdog/service.py

@@ -0,0 +1,199 @@
+"""
+Unified WatchDog Service for monitoring UI Automation events.
+Allows single instantiation to handle multiple monitors (Focus, Structure) safely in one STA thread.
+"""
+from windows_mcp.uia.core import _AutomationClient
+from windows_mcp.uia.enums import TreeScope
+from threading import Thread, Event
+import comtypes.client
+import comtypes
+import logging
+import weakref
+
+from .event_handlers import (
+    FocusChangedEventHandler,
+    StructureChangedEventHandler,
+    PropertyChangedEventHandler
+)
+
+logger = logging.getLogger(__name__)
+logger.setLevel(logging.INFO)
+
+class WatchDog:
+    def __init__(self):
+        self.uia_client = _AutomationClient.instance()
+        self.uia = self.uia_client.IUIAutomation
+        self.is_running = Event()
+        self.thread = None
+
+        # Callbacks
+        self._focus_callback = None
+        self._structure_callback = None
+        self._structure_element = None
+        self._property_callback = None
+        self._property_element = None
+        self._property_ids = None
+        
+        # Internal state for tracking active handlers
+        self._focus_handler = None
+        self._structure_handler = None
+        self._active_structure_element = None
+        self._property_handler = None
+        self._active_property_element = None
+        self._active_property_ids = None
+
+    def __enter__(self):
+        self.start()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.stop()
+
+    def start(self):
+        """Start the watchdog service thread."""
+        if self.is_running.is_set():
+            return
+        self.is_running.set()
+        self.thread = Thread(target=self._run, name="WatchDogThread")
+        self.thread.daemon = True 
+        self.thread.start()
+
+    def stop(self):
+        """Stop the watchdog service thread."""
+        if not self.is_running.is_set():
+            return
+        self.is_running.clear()
+        if self.thread and self.thread.is_alive():
+            self.thread.join(timeout=2.0)
+
+    def set_focus_callback(self, callback):
+        """Set the callback for focus changes. Pass None to disable."""
+        self._focus_callback = callback
+
+    def set_structure_callback(self, callback, element=None):
+        """Set the callback for structure changes. Pass None to disable.
+        Optionally specify an element to watch (defaults to RootElement)."""
+        self._structure_callback = callback
+        self._structure_element = element
+
+    def set_property_callback(self, callback, element=None, property_ids=None):
+        """Set the callback for property changes. Pass None to disable.
+        Optionally specify an element to watch (defaults to RootElement) 
+        and a list of property IDs to monitor."""
+        self._property_callback = callback
+        self._property_element = element
+        self._property_ids = property_ids
+
+    def _run(self):
+        """Main event loop running in a dedicated STA thread."""
+        comtypes.CoInitialize()
+        try:
+            while self.is_running.is_set():
+                # --- Focus Monitoring ---
+                if self._focus_callback and not self._focus_handler:
+                    try:
+                        self._focus_handler = FocusChangedEventHandler(self)
+                        self.uia.AddFocusChangedEventHandler(None, self._focus_handler)
+                    except Exception as e:
+                        logger.debug(f"Failed to add focus handler: {e}")
+                elif not self._focus_callback and self._focus_handler:
+                    try:
+                        self.uia.RemoveFocusChangedEventHandler(self._focus_handler)
+                    except Exception as e:
+                        logger.debug(f"Failed to remove focus handler: {e}")
+                    self._focus_handler = None
+
+                # --- Structure Monitoring ---
+                # Check if we need to UNREGISTER because configuration changed or disabled
+                config_changed = (self._structure_element != self._active_structure_element)
+                
+                should_be_active = (self._structure_callback is not None)
+                is_active = (self._structure_handler is not None)
+
+                if is_active and (not should_be_active or config_changed):
+                    try:
+                        target = self._active_structure_element if self._active_structure_element else self.uia.GetRootElement()
+                        self.uia.RemoveStructureChangedEventHandler(target, self._structure_handler)
+                    except Exception as e:
+                        logger.debug(f"Failed to remove structure handler: {e}")
+                    self._structure_handler = None
+                    self._active_structure_element = None
+                    is_active = False
+
+                if should_be_active and not is_active:
+                    try:
+                        target = self._structure_element if self._structure_element else self.uia.GetRootElement()
+                        scope = TreeScope.TreeScope_Subtree
+                        
+                        self._structure_handler = StructureChangedEventHandler(self)
+                        self.uia.AddStructureChangedEventHandler(target, scope, None, self._structure_handler)
+                        self._active_structure_element = target
+                    except Exception as e:
+                        logger.debug(f"Failed to add structure handler: {e}")
+
+                # --- Property Monitoring ---
+                config_changed = (self._property_element != self._active_property_element) or \
+                               (self._property_ids != self._active_property_ids)
+                
+                should_be_active = (self._property_callback is not None)
+                is_active = (self._property_handler is not None)
+
+                if is_active and (not should_be_active or config_changed):
+                    try:
+                        target = self._active_property_element if self._active_property_element else self.uia.GetRootElement()
+                        self.uia.RemovePropertyChangedEventHandler(target, self._property_handler)
+                    except Exception as e:
+                        print(f"Failed to remove property handler: {e}")
+                    self._property_handler = None
+                    self._active_property_element = None
+                    self._active_property_ids = None
+                    is_active = False
+
+                if should_be_active and not is_active:
+                    try:
+                        target = self._property_element if self._property_element else self.uia.GetRootElement()
+                        scope = TreeScope.TreeScope_Subtree
+                        
+                        # Monitor common properties if none specified
+                        # 30005: Name, 30045: Value, 30093: LegacyIAccessibleVal, 30128: ToggleState
+                        p_ids = self._property_ids if self._property_ids else [30005, 30045, 30093, 30128]
+                        
+                        self._property_handler = PropertyChangedEventHandler(self)
+                        self.uia.AddPropertyChangedEventHandler(target, scope, None, self._property_handler, p_ids)
+                        
+                        self._active_property_element = target
+                        self._active_property_ids = p_ids
+                    except Exception as e:
+                        print(f"Failed to add property handler: {e}")
+
+                # Pump events for this thread
+                comtypes.client.PumpEvents(0.1)
+
+        except Exception as e:
+            print(f"WatchDogService died: {e}")
+        finally:
+            # Cleanup handlers on exit
+            if self._focus_handler:
+                try: 
+                    self.uia.RemoveFocusChangedEventHandler(self._focus_handler)
+                except: pass
+                self._focus_handler = None
+            
+            if self._structure_handler:
+                try:
+                    target = self._active_structure_element if self._active_structure_element else self.uia.GetRootElement()
+                    self.uia.RemoveStructureChangedEventHandler(target, self._structure_handler)
+                except: pass
+                self._structure_handler = None
+                self._active_structure_element = None
+
+            if self._property_handler:
+                try:
+                    target = self._active_property_element if self._active_property_element else self.uia.GetRootElement()
+                    self.uia.RemovePropertyChangedEventHandler(target, self._property_handler)
+                except: pass
+                self._property_handler = None
+                self._active_property_element = None
+                self._active_property_ids = None
+            
+            comtypes.CoUninitialize()

{windows_mcp-0.5.7.dist-info → windows_mcp-0.5.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windows-mcp
-Version: 0.5.7
+Version: 0.5.9
 Summary: Lightweight MCP Server for interacting with Windows Operating System.
 Project-URL: homepage, https://github.com/CursorTouch
 Author-email: Jeomon George <jeogeoalukka@gmail.com>
@@ -29,24 +29,19 @@ License-File: LICENSE.md
 Keywords: ai,ai agent,desktop,mcp,windows
 Requires-Python: >=3.13
 Requires-Dist: click>=8.2.1
-Requires-Dist: fastmcp>=2.8.1
+Requires-Dist: comtypes>=1.4.15
+Requires-Dist: fastmcp>=2.14.2
 Requires-Dist: fuzzywuzzy>=0.18.0
-Requires-Dist: humancursor>=1.1.5
-Requires-Dist: ipykernel>=6.30.0
-Requires-Dist: live-inspect>=0.1.2
 Requires-Dist: markdownify>=1.1.0
-Requires-Dist: pdfplumber>=0.11.7
 Requires-Dist: pillow>=11.2.1
 Requires-Dist: posthog>=7.4.0
 Requires-Dist: psutil>=7.0.0
 Requires-Dist: pyautogui>=0.9.54
-Requires-Dist: pygetwindow>=0.0.9
 Requires-Dist: python-dotenv>=1.1.0
 Requires-Dist: python-levenshtein>=0.27.1
-Requires-Dist: pywinauto>=0.6.9
+Requires-Dist: pywin32>=311
 Requires-Dist: requests>=2.32.3
 Requires-Dist: tabulate>=0.9.0
-Requires-Dist: uiautomation>=2.0.24
 Requires-Dist: uuid7>=0.1.0
 Description-Content-Type: text/markdown
 
@@ -78,7 +73,8 @@ Description-Content-Type: text/markdown
 mcp-name: io.github.CursorTouch/Windows-MCP
 
 ## Updates
-- Windows-MCP is now available on [PyPI](https://pypi.org/project/windows-mcp/) (thus supports `uvx`)
+- Windows-MCP reached 1M+ Users in [Claude Desktop Extensiosn](https://claude.ai/directory). 
+- Windows-MCP is now available on [PyPI](https://pypi.org/project/windows-mcp/) (thus supports `uvx windows-mcp`)
 - Windows-MCP is added to [MCP Registry](https://github.com/modelcontextprotocol/registry)
 - Try out 🪟[Windows-Use](https://github.com/CursorTouch/Windows-Use)!!, an agent built using Windows-MCP.
 - Windows-MCP is now featured as Desktop Extension in `Claude Desktop`.
@@ -114,13 +110,15 @@ mcp-name: io.github.CursorTouch/Windows-MCP
   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.7 to 2.5 secs**, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm.
+  Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.4 to 1.2 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.
 
 ## 🛠️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.13+
@@ -346,17 +344,17 @@ args=[
 
 MCP Client can access the following tools to interact with Windows:
 
-- `Click-Tool`: Click on the screen at the given coordinates.
-- `Type-Tool`: Type text on an element (optionally clears existing text).
-- `Scroll-Tool`: Scroll vertically or horizontally on the window or specific regions.
-- `Drag-Tool`: Drag from one point to another.
-- `Move-Tool`: Move mouse pointer.
-- `Shortcut-Tool`: Press keyboard shortcuts (`Ctrl+c`, `Alt+Tab`, etc).
-- `Wait-Tool`: Pause for a defined duration.
-- `State-Tool`: Combined snapshot of default language, browser, active apps and interactive, textual and scrollable elements along with screenshot of the desktop. Supports `use_dom=True` for browser content extraction (web page elements only) and `use_vision=True` for including screenshots.
-- `App-Tool`: To launch an application from the start menu, resize or move the window and switch between apps.
-- `Shell-Tool`: To execute PowerShell commands.
-- `Scrape-Tool`: To scrape the entire webpage for information.
+- `Click`: Click on the screen at the given coordinates.
+- `Type`: Type text on an element (optionally clears existing text).
+- `Scroll`: Scroll vertically or horizontally on the window or specific regions.
+- `Drag`: Drag from one point to another.
+- `Move`: Move mouse pointer.
+- `Shortcut`: Press keyboard shortcuts (`Ctrl+c`, `Alt+Tab`, etc).
+- `Wait`: Pause for a defined duration.
+- `Snapshot`: Combined snapshot of default language, browser, active apps and interactive, textual and scrollable elements along with screenshot of the desktop. Supports `use_dom=True` for browser content extraction (web page elements only) and `use_vision=True` for including screenshots.
+- `App`: To launch an application from the start menu, resize or move the window and switch between apps.
+- `Shell`: To execute PowerShell commands.
+- `Scrape`: To scrape the entire webpage for information.
 
 ## 🤝 Connect with Us
 Stay updated and join our community:
@@ -369,9 +367,15 @@ Stay updated and join our community:
 
 [![Star History Chart](https://api.star-history.com/svg?repos=CursorTouch/Windows-MCP&type=Date)](https://www.star-history.com/#CursorTouch/Windows-MCP&Date)
 
-## ⚠️Caution
+## 👥 Contributors
+
+Thanks to all the amazing people who have contributed to Windows-MCP! 🎉
 
-This MCP interacts directly with your Windows operating system to perform actions. Use with caution and avoid deploying it in environments where such risks cannot be tolerated.
+<a href="https://github.com/CursorTouch/Windows-MCP/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=CursorTouch/Windows-MCP" />
+</a>
+
+We appreciate every contribution, whether it's code, documentation, bug reports, or feature suggestions. Want to contribute? Check out our [Contributing Guidelines](CONTRIBUTING)!
 
 ## 🔒 Security
 
@@ -407,6 +411,8 @@ To disable telemetry, add the following to your MCP client configuration:
 }
 ```
 
+For detailed information on what data is collected and how it is handled, please refer to the [Telemetry and Data Privacy](SECURITY.md#telemetry-and-data-privacy) section in our Security Policy.
+
 ## 📝 Limitations
 
 - Selecting specific sections of the text in a paragraph, as the MCP is relying on a11y tree. (⌛ Working on it.)

windows_mcp-0.5.9.dist-info/RECORD

@@ -0,0 +1,29 @@
+windows_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+windows_mcp/__main__.py,sha256=fWKa82Rp-xbsfpiEHKkv0C4AckKI7Rz6flE11qxirIY,12993
+windows_mcp/analytics.py,sha256=yir5IWAI_YN9dmy9KOVIRYsZbeAO12INcxvY2WJSWCU,6307
+windows_mcp/desktop/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+windows_mcp/desktop/config.py,sha256=LxMWSyYOUfMKzkk5ts46dV1NrAnukS2zHjTfyEKRc-A,364
+windows_mcp/desktop/service.py,sha256=oT0fDW-uz3p3xdexPS88Y5PvTkfrLwa5boW_sFkJl7M,26142
+windows_mcp/desktop/views.py,sha256=5EEeG4aPDFPqxx0Fhs8ejfHC-eC7Bt2ezOYpOerVBwM,1578
+windows_mcp/tree/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+windows_mcp/tree/cache_utils.py,sha256=xuS4Gt96Az8eYoo9cu464NRZWuGQngDCgAhT2iYX-j8,5361
+windows_mcp/tree/config.py,sha256=2UbH76pA5VdlbFQ8-PCog-MoGxLmk5Pv1mvfAAg_9HQ,1496
+windows_mcp/tree/service.py,sha256=KWFfH8Setzf0YAO1S4sVcMsRHbpQamD5_tba8rUdEz0,30518
+windows_mcp/tree/utils.py,sha256=YaUqg_pK4pnii0Idzo0bwYcf7Xo3FQsxzwGNL7Qh1L4,893
+windows_mcp/tree/views.py,sha256=OHxjuF2FpxdSZeD6CIO0Ec64jaZSEBXIH_dcvmq0CmA,4794
+windows_mcp/uia/__init__.py,sha256=ePdeJOHmTihMedolZUEL59nKDXsBVyofT80miP_5G-Y,93
+windows_mcp/uia/controls.py,sha256=xIRMJkktj0UzTeaxPO8g51aBV8Y9wL_EbrUZt77SgQY,223941
+windows_mcp/uia/core.py,sha256=sgtzb8QmevNWuv_nORF3F_wU97TxCjZWZlpYPYWcoS8,132131
+windows_mcp/uia/enums.py,sha256=DYcypTL8zkygdjZUezE2jgz9RMBM9AWe8ofvubLHRCg,83577
+windows_mcp/uia/events.py,sha256=9Xwcn-X1dy2t6WlbwDsIedcKq1SIIHGZ183qpohfFBk,4726
+windows_mcp/uia/patterns.py,sha256=CShOYqYMv7wdwDpNYZZZU3WZuLMvYhAAmnbzQ2Hx7aA,102692
+windows_mcp/vdm/__init__.py,sha256=nE8jJjGJaKuJKCyuf6QLfrj8xPj8IqGKeH2VXP3FMzY,21
+windows_mcp/vdm/core.py,sha256=OQFgkmt-hscUJc-fzBOS_klmCiax-wSTPRaX3TNDJbQ,21404
+windows_mcp/watchdog/__init__.py,sha256=ExC350_KZXwTENsLQfESSPUJZfwsEjrAvGtLRPCqqjk,31
+windows_mcp/watchdog/event_handlers.py,sha256=mHw2msgAjkGuYwTp-U6tYX-gL4S7N1J1HQNmyQ-sdVk,2052
+windows_mcp/watchdog/service.py,sha256=9Tpoq8Ma3MF0Zq7yJKkLOx8NCm4bcUeJY_P1GPkjeLk,9099
+windows_mcp-0.5.9.dist-info/METADATA,sha256=OlwcJWkX4z-ZDOLdwAjGqiRxzNupISf0WvFHhRq8F5A,14545
+windows_mcp-0.5.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+windows_mcp-0.5.9.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
+windows_mcp-0.5.9.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
+windows_mcp-0.5.9.dist-info/RECORD,,

windows_mcp-0.5.7.dist-info/RECORD

@@ -1,17 +0,0 @@
-windows_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-windows_mcp/__main__.py,sha256=TryfZevJMW53N3m8qcQXDqhcYu2KAGCbZ6ibrJjfS2o,13280
-windows_mcp/analytics.py,sha256=kXQ2MEUaUnZUvq0nfm03YIN0kHcSq2z2dNFcFirO5Kc,6455
-windows_mcp/desktop/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-windows_mcp/desktop/config.py,sha256=7rAb64pmC275PpNRXVOyOf0Psu089AOosRC8T5kVGWA,384
-windows_mcp/desktop/service.py,sha256=gJO46Hs508tJrGKOaaFkx9SxtPhEucboI3eXeI3uro0,18486
-windows_mcp/desktop/views.py,sha256=_hZ5sfY1uWVi5mpaysVd-plwP_DT6SXpKa33Z8WT6gI,1523
-windows_mcp/tree/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-windows_mcp/tree/config.py,sha256=k-Mjo_yIn0d1AzcEW_bxiaXyBFxBZZSyy7hCNQ3XVp0,1010
-windows_mcp/tree/service.py,sha256=evK62AwhMwifpq6lRQCdrmC4DPt1-w_HSp8nUwXsCVQ,23566
-windows_mcp/tree/utils.py,sha256=6hbxdIQPrAY-I3jcHsRqodHlxboTQj2GnLA71bf1lqY,911
-windows_mcp/tree/views.py,sha256=K2hTBDicjP4p_tPIRTLZ8Sq3pGYhsDtZVIROAnMGTz4,3599
-windows_mcp-0.5.7.dist-info/METADATA,sha256=xbvl6qR69-KSMLqjga6gutc8goRD4IQ7jm_zyKPT2Ko,14019
-windows_mcp-0.5.7.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-windows_mcp-0.5.7.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
-windows_mcp-0.5.7.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
-windows_mcp-0.5.7.dist-info/RECORD,,