windows-mcp 0.5.5__tar.gz → 0.5.7__tar.gz

windows_mcp-0.5.7/.mcpbignore

@@ -0,0 +1,5 @@
+.venv
+__pycache__
+build
+dist
+notebook.ipynb

{windows_mcp-0.5.5 → windows_mcp-0.5.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windows-mcp
-Version: 0.5.5
+Version: 0.5.7
 Summary: Lightweight MCP Server for interacting with Windows Operating System.
 Project-URL: homepage, https://github.com/CursorTouch
 Author-email: Jeomon George <jeogeoalukka@gmail.com>
@@ -33,18 +33,21 @@ Requires-Dist: fastmcp>=2.8.1
 Requires-Dist: fuzzywuzzy>=0.18.0
 Requires-Dist: humancursor>=1.1.5
 Requires-Dist: ipykernel>=6.30.0
-Requires-Dist: live-inspect>=0.1.1
+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: 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
 
 [![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cursortouch-windows-mcp-badge.png)](https://mseep.ai/app/cursortouch-windows-mcp)
@@ -261,7 +264,6 @@ npm install -g @google/gemini-cli
 {
   "theme": "Default",
   ...
-//MCP Server Config
   "mcpServers": {
     "windows-mcp": {
       "command": "uvx",
@@ -295,7 +297,6 @@ npm install -g @qwen-code/qwen-code@latest
 
 ```json
 {
-//MCP Server Config
   "mcpServers": {
     "windows-mcp": {
       "command": "uvx",
@@ -384,6 +385,28 @@ For detailed security information, including:
 
 Please read our [Security Policy](SECURITY.md).
 
+## 📊 Telemetry
+
+Windows-MCP collects usage data to help improve the MCP server. No personal information, no tool arguments, no outputs are tracked.
+
+To disable telemetry, add the following to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "windows-mcp": {
+      "command": "uvx",
+      "args": [
+        "windows-mcp"
+      ],
+      "env": {
+        "ANONYMIZED_TELEMETRY": "false"
+      }
+    }
+  }
+}
+```
+
 ## 📝 Limitations
 
 - Selecting specific sections of the text in a paragraph, as the MCP is relying on a11y tree. (⌛ Working on it.)
@@ -421,3 +444,4 @@ Made with ❤️ by [CursorTouch](https://github.com/CursorTouch)
   url={https://github.com/CursorTouch/Windows-MCP}
 }
 ```
+

{windows_mcp-0.5.5 → windows_mcp-0.5.7}/README.md

@@ -212,7 +212,6 @@ npm install -g @google/gemini-cli
 {
   "theme": "Default",
   ...
-//MCP Server Config
   "mcpServers": {
     "windows-mcp": {
       "command": "uvx",
@@ -246,7 +245,6 @@ npm install -g @qwen-code/qwen-code@latest
 
 ```json
 {
-//MCP Server Config
   "mcpServers": {
     "windows-mcp": {
       "command": "uvx",
@@ -335,6 +333,28 @@ For detailed security information, including:
 
 Please read our [Security Policy](SECURITY.md).
 
+## 📊 Telemetry
+
+Windows-MCP collects usage data to help improve the MCP server. No personal information, no tool arguments, no outputs are tracked.
+
+To disable telemetry, add the following to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "windows-mcp": {
+      "command": "uvx",
+      "args": [
+        "windows-mcp"
+      ],
+      "env": {
+        "ANONYMIZED_TELEMETRY": "false"
+      }
+    }
+  }
+}
+```
+
 ## 📝 Limitations
 
 - Selecting specific sections of the text in a paragraph, as the MCP is relying on a11y tree. (⌛ Working on it.)
@@ -372,3 +392,4 @@ Made with ❤️ by [CursorTouch](https://github.com/CursorTouch)
   url={https://github.com/CursorTouch/Windows-MCP}
 }
 ```
+

{windows_mcp-0.5.5 → windows_mcp-0.5.7}/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.2",
   "name": "Windows-MCP",
-  "version": "0.5.0",
+  "version": "0.5.6",
   "description": "MCP Server that enables Claude to interact with Windows OS",
   "long_description": "Windows MCP is an 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.\\n\\n## Key Features\\n\\n- **Seamless Windows Integration**: Interacts natively with Windows UI elements, opens apps, controls windows, simulates user input, and more.\\n- **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.\\n- **Rich Toolset for UI Automation**: Includes tools for basic keyboard, mouse operation and capturing window/UI state.\\n- **Lightweight & Open-Source**: Minimal dependencies and easy setup with full source code available under MIT license.\\n- **Customizable & Extendable**: Easily adapt or extend tools to suit your unique automation or AI integration needs.\\n- **Real-Time Interaction**: Typical latency between actions (e.g., from one mouse click to the next) ranges from **1.5 to 2.3 secs**, and may slightly vary based on the number of active applications and system load, also the inferencing speed of the llm.\\n\\n## Requirements\\n\\n### UV Package Manager\\nThis MCP server requires [UV](https://github.com/astral-sh/uv), a fast Python package manager. \\n\\n```bash\\npip install uv\\n```\\n\\nFor detailed installation instructions, see the [UV documentation](https://github.com/astral-sh/uv#installation).",
   "author": {
@@ -19,15 +19,27 @@
   ],
   "server": {
     "type": "python",
-    "entry_point": "main.py",
+    "entry_point": "./src/windows_mcp/__main__.py",
     "mcp_config": {
       "command": "uv",
       "args": [
         "--directory",
         "${__dirname}",
         "run",
-        "main.py"
-      ]
+        "windows-mcp"
+      ],
+      "env": {
+        "ANONYMIZED_TELEMETRY": "${user_config.anonymized_telemetry}"
+      }
+    }
+  },
+  "user_config": {
+    "anonymized_telemetry": {
+      "type": "boolean",
+      "title": "Anonymized Telemetry",
+      "description": "Windows-MCP collects usage data to help improve the MCP server. No personal information, no tool arguments, no outputs are tracked.",
+      "required": false,
+      "default": true
     }
   },
   "tools": [
@@ -73,7 +85,7 @@
     },
     {
       "name": "Scrape Tool",
-      "description": "Fetch and convert webpage content to markdown format. Provide full URL including protocol (http/https). Returns structured text content suitable for analysis."
+      "description": "Fetch content from a URL or the active browser tab. By default (use_dom=False), performs a lightweight HTTP request to the URL and returns markdown content of complete webpage. Note: Some websites may block automated HTTP requests. If this fails, open the page in a browser and retry with use_dom=True to extract visible text from the active tab's DOM within the viewport."
     }
   ],
   "compatibility": {

{windows_mcp-0.5.5 → windows_mcp-0.5.7}/pyproject.toml

@@ -1,40 +1,43 @@
-[project]
-name = "windows-mcp"
-version = "0.5.5"
-description = "Lightweight MCP Server for interacting with Windows Operating System."
-authors = [
-    { name = "Jeomon George", email = "jeogeoalukka@gmail.com" }
-]
-readme = "README.md"
-license = { file = "LICENSE.md" }
-urls = { homepage = "https://github.com/CursorTouch" }
-keywords = ["windows", "mcp", "ai", "desktop","ai agent"]
-requires-python = ">=3.13"
-dependencies = [
-    "click>=8.2.1",
-    "fastmcp>=2.8.1",
-    "fuzzywuzzy>=0.18.0",
-    "humancursor>=1.1.5",
-    "ipykernel>=6.30.0",
-    "live-inspect>=0.1.1",
-    "markdownify>=1.1.0",
-    "pdfplumber>=0.11.7",
-    "pillow>=11.2.1",
-    "psutil>=7.0.0",
-    "pyautogui>=0.9.54",
-    "pygetwindow>=0.0.9",
-    "python-levenshtein>=0.27.1",
-    "pywinauto>=0.6.9",
-    "requests>=2.32.3",
-    "tabulate>=0.9.0",
-    "uiautomation>=2.0.24",
-]
-
-[project.scripts]
-windows-mcp = "windows_mcp.__main__:main"
-
-[build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
-
-
+[project]
+name = "windows-mcp"
+version = "0.5.7"
+description = "Lightweight MCP Server for interacting with Windows Operating System."
+authors = [
+    { name = "Jeomon George", email = "jeogeoalukka@gmail.com" }
+]
+readme = "README.md"
+license = { file = "LICENSE.md" }
+urls = { homepage = "https://github.com/CursorTouch" }
+keywords = ["windows", "mcp", "ai", "desktop","ai agent"]
+requires-python = ">=3.13"
+dependencies = [
+    "click>=8.2.1",
+    "fastmcp>=2.8.1",
+    "fuzzywuzzy>=0.18.0",
+    "humancursor>=1.1.5",
+    "ipykernel>=6.30.0",
+    "live-inspect>=0.1.2",
+    "markdownify>=1.1.0",
+    "pdfplumber>=0.11.7",
+    "pillow>=11.2.1",
+    "posthog>=7.4.0",
+    "psutil>=7.0.0",
+    "pyautogui>=0.9.54",
+    "pygetwindow>=0.0.9",
+    "python-dotenv>=1.1.0",
+    "python-levenshtein>=0.27.1",
+    "pywinauto>=0.6.9",
+    "requests>=2.32.3",
+    "tabulate>=0.9.0",
+    "uiautomation>=2.0.24",
+    "uuid7>=0.1.0",
+]
+
+[project.scripts]
+windows-mcp = "windows_mcp.__main__:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+

{windows_mcp-0.5.5 → windows_mcp-0.5.7}/src/windows_mcp/__main__.py

@@ -1,15 +1,20 @@
+from windows_mcp.analytics import PostHogAnalytics, with_analytics
 from live_inspect.watch_cursor import WatchCursor
+from windows_mcp.desktop.service import Desktop
 from contextlib import asynccontextmanager
 from fastmcp.utilities.types import Image
-from windows_mcp.desktop.service import Desktop
 from mcp.types import ToolAnnotations
+from typing import Literal, Optional
 from humancursor import SystemCursor
+from fastmcp import FastMCP, Context
+from dotenv import load_dotenv
 from textwrap import dedent
-from fastmcp import FastMCP
-from typing import Literal
 import pyautogui as pg
 import asyncio
 import click
+import os
+
+load_dotenv()
 
 pg.FAILSAFE=False
 pg.PAUSE=1.0
@@ -26,6 +31,12 @@ Windows MCP server provides tools to interact directly with the {windows_version
 thus enabling to operate the desktop on the user's behalf.
 ''')
 
+# Initialize analytics at module level to be used in decorators
+if os.getenv("ANONYMIZED_TELEMETRY", "true").lower() == "false":
+    analytics = None
+else:
+    analytics = PostHogAnalytics()
+
 @asynccontextmanager
 async def lifespan(app: FastMCP):
     """Runs initialization code before the server starts and cleanup code after it shuts down."""
@@ -35,6 +46,8 @@ async def lifespan(app: FastMCP):
         yield
     finally:
         watch_cursor.stop()
+        if analytics:
+            await analytics.close()
 
 mcp=FastMCP(name='windows-mcp',instructions=instructions,lifespan=lifespan)
 
@@ -49,7 +62,8 @@ mcp=FastMCP(name='windows-mcp',instructions=instructions,lifespan=lifespan)
         openWorldHint=False
     )
     )
-def app_tool(mode:Literal['launch','resize','switch'],name:str|None=None,window_loc:list[int]|None=None,window_size:list[int]|None=None):
+@with_analytics(analytics, "App-Tool")
+def app_tool(mode:Literal['launch','resize','switch'],name:str|None=None,window_loc:list[int]|None=None,window_size:list[int]|None=None, ctx: Context = None):
     return desktop.app(mode,name,window_loc,window_size)
     
 @mcp.tool(
@@ -63,7 +77,8 @@ def app_tool(mode:Literal['launch','resize','switch'],name:str|None=None,window_
         openWorldHint=True
     )
     )
-def powershell_tool(command: str) -> str:
+@with_analytics(analytics, "Powershell-Tool")
+def powershell_tool(command: str, ctx: Context = None) -> str:
     response,status_code=desktop.execute_command(command)
     return f'Response: {response}\nStatus Code: {status_code}'
 
@@ -78,7 +93,8 @@ def powershell_tool(command: str) -> str:
         openWorldHint=False
     )
     )
-def state_tool(use_vision:bool=False,use_dom:bool=False):
+@with_analytics(analytics, "State-Tool")
+def state_tool(use_vision:bool=False,use_dom:bool=False, ctx: Context = None):
     # Calculate scale factor to cap resolution at 1080p (1920x1080)
     max_width, max_height = 1920, 1080
     scale_width = max_width / screen_width if screen_width > max_width else 1.0
@@ -118,7 +134,8 @@ def state_tool(use_vision:bool=False,use_dom:bool=False):
         openWorldHint=False
     )
     )
-def click_tool(loc:list[int],button:Literal['left','right','middle']='left',clicks:int=1)->str:
+@with_analytics(analytics, "Click-Tool")
+def click_tool(loc:list[int],button:Literal['left','right','middle']='left',clicks:int=1, ctx: Context = None)->str:
     if len(loc) != 2:
         raise ValueError("Location must be a list of exactly 2 integers [x, y]")
     x,y=loc[0],loc[1]
@@ -137,7 +154,8 @@ def click_tool(loc:list[int],button:Literal['left','right','middle']='left',clic
         openWorldHint=False
     )
     )
-def type_tool(loc:list[int],text:str,clear:bool=False,press_enter:bool=False)->str:
+@with_analytics(analytics, "Type-Tool")
+def type_tool(loc:list[int],text:str,clear:bool=False,press_enter:bool=False, ctx: Context = None)->str:
     if len(loc) != 2:
         raise ValueError("Location must be a list of exactly 2 integers [x, y]")
     x,y=loc[0],loc[1]
@@ -155,7 +173,8 @@ def type_tool(loc:list[int],text:str,clear:bool=False,press_enter:bool=False)->s
         openWorldHint=False
     )
     )
-def scroll_tool(loc:list[int]=None,type:Literal['horizontal','vertical']='vertical',direction:Literal['up','down','left','right']='down',wheel_times:int=1)->str:
+@with_analytics(analytics, "Scroll-Tool")
+def scroll_tool(loc:list[int]=None,type:Literal['horizontal','vertical']='vertical',direction:Literal['up','down','left','right']='down',wheel_times:int=1, ctx: Context = None)->str:
     if loc and len(loc) != 2:
         raise ValueError("Location must be a list of exactly 2 integers [x, y]")
     response=desktop.scroll(loc,type,direction,wheel_times)
@@ -174,7 +193,8 @@ def scroll_tool(loc:list[int]=None,type:Literal['horizontal','vertical']='vertic
         openWorldHint=False
     )
     )
-def drag_tool(to_loc:list[int])->str:
+@with_analytics(analytics, "Drag-Tool")
+def drag_tool(to_loc:list[int], ctx: Context = None)->str:
     if len(to_loc) != 2:
         raise ValueError("to_loc must be a list of exactly 2 integers [x, y]")
     desktop.drag(to_loc)
@@ -192,7 +212,8 @@ def drag_tool(to_loc:list[int])->str:
         openWorldHint=False
     )
     )
-def move_tool(to_loc:list[int])->str:
+@with_analytics(analytics, "Move-Tool")
+def move_tool(to_loc:list[int], ctx: Context = None)->str:
     if len(to_loc) != 2:
         raise ValueError("to_loc must be a list of exactly 2 integers [x, y]")
     x,y=to_loc[0],to_loc[1]
@@ -210,7 +231,8 @@ def move_tool(to_loc:list[int])->str:
         openWorldHint=False
     )
     )
-def shortcut_tool(shortcut:str):
+@with_analytics(analytics, "Shortcut-Tool")
+def shortcut_tool(shortcut:str, ctx: Context = None):
     desktop.shortcut(shortcut)
     return f"Pressed {shortcut}."
 
@@ -225,13 +247,14 @@ def shortcut_tool(shortcut:str):
         openWorldHint=False
     )
     )
-def wait_tool(duration:int)->str:
+@with_analytics(analytics, "Wait-Tool")
+def wait_tool(duration:int, ctx: Context = None)->str:
     pg.sleep(duration)
     return f'Waited for {duration} seconds.'
 
 @mcp.tool(
     name='Scrape-Tool',
-    description='Extracts visible text content from the currently focused browser tab. Returns content in plain text format with scroll status indicators (top/bottom reached or more content available). Only works when a browser with DOM is active. Use State-Tool with use_dom=True first to ensure browser is ready.',
+    description='Fetch content from a URL or the active browser tab. By default (use_dom=False), performs a lightweight HTTP request to the URL and returns markdown content of complete webpage. Note: Some websites may block automated HTTP requests. If this fails, open the page in a browser and retry with use_dom=True to extract visible text from the active tab\'s DOM within the viewport.',
     annotations=ToolAnnotations(
         title="Scrape Tool",
         readOnlyHint=True,
@@ -240,8 +263,13 @@ def wait_tool(duration:int)->str:
         openWorldHint=True
     )
     )
-def scrape_tool(url:str)->str:
-    desktop_state=desktop.desktop_state
+@with_analytics(analytics, "Scrape-Tool")
+def scrape_tool(url:str,use_dom:bool=False, ctx: Context = None)->str:
+    if not use_dom:
+        content=desktop.scrape(url)
+        return f'URL:{url}\nContent:\n{content}'
+
+    desktop_state=desktop.get_state(use_vision=False,use_dom=use_dom)
     tree_state=desktop_state.tree_state
     if not tree_state.dom_info:
         return f'No DOM information found. Please open {url} in browser first.'
@@ -250,7 +278,7 @@ def scrape_tool(url:str)->str:
     content='\n'.join([node.text for node in tree_state.dom_informative_nodes])
     header_status = "Reached top" if vertical_scroll_percent <= 0 else "Scroll up to see more"
     footer_status = "Reached bottom" if vertical_scroll_percent >= 100 else "Scroll down to see more"
-    return f'URL:{url}\nContent:\n{header_status}\n{content}\n{footer_status}'
+    return f'URL:{url}\nContent:\n[{header_status}]\n{content}\n[{footer_status}]'
 
 
 @click.command()

windows_mcp-0.5.7/src/windows_mcp/analytics.py

@@ -0,0 +1,171 @@
+from typing import Optional, Dict, Any, TypeVar, Callable, Protocol, Awaitable
+from tempfile import TemporaryDirectory
+from uuid_extensions import uuid7str
+from fastmcp import Context
+from functools import wraps
+from pathlib import Path
+import posthog
+import asyncio
+import logging
+import time
+import os
+
+logging.basicConfig(level=logging.DEBUG)
+logger = logging.getLogger(__name__)
+
+T = TypeVar("T")
+
+class Analytics(Protocol):
+    async def track_tool(self, tool_name: str, result: Dict[str, Any]) -> None:
+        """Tracks the execution of a tool."""
+        ...
+
+    async def track_error(self, error: Exception, context: Dict[str, Any]) -> None:
+        """Tracks an error that occurred during the execution of a tool."""
+        ...
+
+    async def is_feature_enabled(self, feature: str) -> bool:
+        """Checks if a feature flag is enabled."""
+        ...
+
+    async def close(self) -> None:
+        """Closes the analytics client."""
+        ...
+
+class PostHogAnalytics:
+    TEMP_FOLDER = Path(TemporaryDirectory().name).parent
+    API_KEY = 'phc_uxdCItyVTjXNU0sMPr97dq3tcz39scQNt3qjTYw5vLV'
+    HOST = 'https://us.i.posthog.com'
+
+    def __init__(self):
+        self.client = posthog.Posthog(
+            self.API_KEY, 
+            host=self.HOST, 
+            disable_geoip=False, 
+            enable_exception_autocapture=True,
+            debug=True
+        )
+        self._user_id = None
+        self.mcp_interaction_id = f"mcp_{int(time.time()*1000)}_{os.getpid()}"
+        
+        if self.client:
+            logger.debug(f"Initialized with user ID: {self.user_id} and session ID: {self.mcp_interaction_id}")
+
+    @property
+    def user_id(self) -> str:
+        if self._user_id:
+            return self._user_id
+            
+        user_id_file = self.TEMP_FOLDER / '.windows-mcp-user-id'
+        if user_id_file.exists():
+            self._user_id = user_id_file.read_text(encoding='utf-8').strip()
+        else:
+            self._user_id = uuid7str()
+            try:
+                user_id_file.write_text(self._user_id, encoding='utf-8')
+            except Exception as e:
+                logger.warning(f"Could not persist user ID: {e}")
+                
+        return self._user_id
+
+    async def track_tool(self, tool_name: str, result: Dict[str, Any]) -> None:
+        if self.client:
+            self.client.capture(
+                distinct_id=self.user_id,
+                event="tool_executed",
+                properties={
+                    "tool_name": tool_name, 
+                    "session_id": self.mcp_interaction_id,
+                    "process_person_profile": True,
+                    **result
+                }
+            )
+        
+        duration = result.get("duration_ms", 0)
+        success_mark = "SUCCESS" if result.get("success") else "FAILED"
+        # Using print for immediate visibility in console during debugging
+        print(f"[Analytics] {tool_name}: {success_mark} ({duration}ms)")
+        logger.info(f"{tool_name}: {success_mark} ({duration}ms)")
+        if self.client:
+            self.client.flush()
+
+    async def track_error(self, error: Exception, context: Dict[str, Any]) -> None:
+        if self.client:
+            self.client.capture(
+                 distinct_id=self.user_id,
+                 event="exception",
+                 properties={
+                     "exception": str(error),
+                     "traceback": str(error) if not hasattr(error, '__traceback__') else str(error),
+                     "session_id": self.mcp_interaction_id,
+                     "process_person_profile": True,
+                     **context
+                 }
+            )
+        
+        if self.client:
+            self.client.flush()
+        
+        logger.error(f"ERROR in {context.get('tool_name')}: {error}")
+
+    async def is_feature_enabled(self, feature: str) -> bool:
+        if not self.client:
+            return False
+        return self.client.is_feature_enabled(feature, self.user_id)
+
+    async def close(self) -> None:
+        if self.client:
+            self.client.shutdown()
+            logger.debug("Closed analytics")
+
+def with_analytics(analytics_instance: Optional[Analytics], tool_name: str):
+    """
+    Decorator to wrap tool functions with analytics tracking.
+    """
+    def decorator(func: Callable[..., Awaitable[T]]) -> Callable[..., Awaitable[T]]:
+        @wraps(func)
+        async def wrapper(*args, **kwargs) -> T:
+            start = time.time()
+            
+            # Capture client info from Context passed as argument
+            client_data = {}
+            try:
+                ctx = next((arg for arg in args if isinstance(arg, Context)), None)
+                if not ctx:
+                    ctx = next((val for val in kwargs.values() if isinstance(val, Context)), None)
+
+                if ctx and ctx.session and ctx.session.client_params and ctx.session.client_params.clientInfo:
+                    info = ctx.session.client_params.clientInfo
+                    client_data["client_name"] = info.name
+                    client_data["client_version"] = info.version
+            except Exception:
+                pass
+
+            try:
+                if asyncio.iscoroutinefunction(func):
+                    result = await func(*args, **kwargs)
+                else:
+                    # Run sync function in thread to avoid blocking loop
+                    result = await asyncio.to_thread(func, *args, **kwargs)
+
+                duration_ms = int((time.time() - start) * 1000)
+                
+                if analytics_instance:
+                    await analytics_instance.track_tool(tool_name, {
+                        "duration_ms": duration_ms, 
+                        "success": True, 
+                        **client_data
+                    })
+                
+                return result
+            except Exception as error:
+                duration_ms = int((time.time() - start) * 1000)
+                if analytics_instance:
+                    await analytics_instance.track_error(error, {
+                        "tool_name": tool_name,
+                        "duration_ms": duration_ms,
+                        **client_data
+                    })
+                raise error
+        return wrapper
+    return decorator

{windows_mcp-0.5.5 → windows_mcp-0.5.7}/src/windows_mcp/desktop/service.py

@@ -1,10 +1,10 @@
 from windows_mcp.desktop.config import BROWSER_NAMES, PROCESS_PER_MONITOR_DPI_AWARE
 from windows_mcp.desktop.views import DesktopState, App, Size, Status
+from windows_mcp.tree.service import Tree
 from locale import getpreferredencoding
 from contextlib import contextmanager
 from typing import Optional,Literal
 from markdownify import markdownify
-from windows_mcp.tree.service import Tree
 from fuzzywuzzy import process
 from psutil import Process
 from time import sleep
@@ -53,7 +53,7 @@ class Desktop:
         sleep(0.1)
         apps=self.get_apps()
         active_app=self.get_active_app()
-        if active_app is not None:
+        if active_app is not None and active_app in apps:
             apps.remove(active_app)
         logger.debug(f"Active app: {active_app}")
         logger.debug(f"Apps: {apps}")
@@ -172,7 +172,7 @@ class Desktop:
                 sleep(1.25)
                 if status!=0:
                     return response
-                consecutive_waits=3
+                consecutive_waits=10
                 for _ in range(consecutive_waits):
                     if not self.is_app_running(name):
                         sleep(1.25)
@@ -200,11 +200,12 @@ class Desktop:
         app_name,_=matched_app
         appid=apps_map.get(app_name)
         if appid is None:
-            return (name,f'{name.title()} not found in start menu.',1)
-        if name.endswith('.exe'):
-            response,status=self.execute_command(f'Start-Process {appid}')
+            return (f'{name.title()} not found in start menu.',1)
+        if appid.endswith('.exe'):
+            command=f"Start-Process '{appid}'"
         else:
-            response,status=self.execute_command(f'Start-Process shell:AppsFolder\\{appid}')
+            command=f"Start-Process shell:AppsFolder\\{appid}"
+        response,status=self.execute_command(command)
         return response,status
     
     def switch_app(self,name:str):

{windows_mcp-0.5.5 → windows_mcp-0.5.7}/uv.lock

@@ -63,6 +63,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/84/29/587c189bbab1ccc8c86a03a5d0e13873df916380ef1be461ebe6acebf48d/authlib-1.6.0-py2.py3-none-any.whl", hash = "sha256:91685589498f79e8655e8a8947431ad6288831d643f11c55c2143ffcc738048d", size = 239981, upload-time = "2025-05-23T00:21:43.075Z" },
 ]
 
+[[package]]
+name = "backoff"
+version = "2.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/47/d7/5bbeb12c44d7c4f2fb5b56abce497eb5ed9f34d85701de869acedd602619/backoff-2.2.1.tar.gz", hash = "sha256:03f829f5bb1923180821643f8753b0502c3b682293992485b0eef2807afa5cba", size = 17001, upload-time = "2022-10-05T19:19:32.061Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/df/73/b6e24bd22e6720ca8ee9a85a0c4a2971af8497d8f3193fa05390cbd46e09/backoff-2.2.1-py3-none-any.whl", hash = "sha256:63579f9a0628e06278f7e47b7d7d5b6ce20dc65c5e96a6f3ca99a6adca0396e8", size = 15148, upload-time = "2022-10-05T19:19:30.546Z" },
+]
+
 [[package]]
 name = "beautifulsoup4"
 version = "4.13.4"
@@ -246,6 +255,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/4e/8c/f3147f5c4b73e7550fe5f9352eaa956ae838d5c51eb58e7a25b9f3e2643b/decorator-5.2.1-py3-none-any.whl", hash = "sha256:d316bb415a2d9e2d2b3abcc4084c6502fc09240e292cd76a76afc106a1c8e04a", size = 9190, upload-time = "2025-02-24T04:41:32.565Z" },
 ]
 
+[[package]]
+name = "distro"
+version = "1.9.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fc/f8/98eea607f65de6527f8a2e8885fc8015d3e6f5775df186e443e0964a11c3/distro-1.9.0.tar.gz", hash = "sha256:2fa77c6fd8940f116ee1d6b94a2f90b13b5ea8d019b98bc8bafdcabcdd9bdbed", size = 60722, upload-time = "2023-12-24T09:54:32.31Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/12/b3/231ffd4ab1fc9d679809f356cebee130ac7daa00d6d6f3206dd4fd137e9e/distro-1.9.0-py3-none-any.whl", hash = "sha256:7bffd925d65168f85027d8da9af6bddab658135b840670a223589bc0c8ef02b2", size = 20277, upload-time = "2023-12-24T09:54:30.421Z" },
+]
+
 [[package]]
 name = "exceptiongroup"
 version = "1.3.0"
@@ -488,15 +506,15 @@ wheels = [
 
 [[package]]
 name = "live-inspect"
-version = "0.1.1"
+version = "0.1.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "clr" },
     { name = "pythonnet" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/49/19/17117df902e41bff25d0880b7e72ea7def90c0f575d9704abc8707728e1f/live_inspect-0.1.1.tar.gz", hash = "sha256:b2beaf0a74dd8656aeac9343810e09c5a8efa83c2ce183577040cae7e3acd80a", size = 235834, upload-time = "2025-06-25T14:04:00.17Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/57/e8/720c2b160126c19d1b03decc7db4f5101f05c8a6e83875da845eb383f6a5/live_inspect-0.1.2.tar.gz", hash = "sha256:c78e4f59f080c8c53486fa4a8686651b5af0fcbec43c9cd651c5eb703df9a19d", size = 235924, upload-time = "2025-12-19T21:11:36.083Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/45/f7/3ee6a7ddb88ad0bf8e4fbc581f90a55079b383c1c1ac229917d6da7dd198/live_inspect-0.1.1-py3-none-any.whl", hash = "sha256:406daee02db1d5b76783ad61952582caf76aae02c816ad466d788f6dd671199d", size = 237608, upload-time = "2025-06-25T14:03:58.638Z" },
+    { url = "https://files.pythonhosted.org/packages/84/98/ad29db410762e9415a5171b0da7d6a282f45070f2ca13df12fd084c0072f/live_inspect-0.1.2-py3-none-any.whl", hash = "sha256:de1966789a3d745c33dbf914dea81e42c7dcb7f5561ce4fe3deefb9cbfbbbf73", size = 237670, upload-time = "2025-12-19T21:11:34.013Z" },
 ]
 
 [[package]]
@@ -733,6 +751,23 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/fe/39/979e8e21520d4e47a0bbe349e2713c0aac6f3d853d0e5b34d76206c439aa/platformdirs-4.3.8-py3-none-any.whl", hash = "sha256:ff7059bb7eb1179e2685604f4aaf157cfd9535242bd23742eadc3c13542139b4", size = 18567, upload-time = "2025-05-07T22:47:40.376Z" },
 ]
 
+[[package]]
+name = "posthog"
+version = "7.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "backoff" },
+    { name = "distro" },
+    { name = "python-dateutil" },
+    { name = "requests" },
+    { name = "six" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/14/e5/5262d1604a3eb19b23d4e896bce87b4603fd39ec366a96b27e19e3299aef/posthog-7.4.0.tar.gz", hash = "sha256:1fb97b11960e24fcf0b80f0a6450b2311478e5a3ee6ea3c6f9284ff89060a876", size = 143780, upload-time = "2025-12-16T23:42:05.829Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9f/8b/13066693d7a6f94fb5da3407417bbbc3f6aa8487051294d0ef766c1567fa/posthog-7.4.0-py3-none-any.whl", hash = "sha256:f9d4e32c1c0f2110256b1aae7046ed90af312c1dbb1eecc6a9cb427733b22970", size = 166079, upload-time = "2025-12-16T23:42:04.33Z" },
+]
+
 [[package]]
 name = "prompt-toolkit"
 version = "3.0.51"
@@ -1394,6 +1429,15 @@ socks = [
     { name = "pysocks" },
 ]
 
+[[package]]
+name = "uuid7"
+version = "0.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/5c/19/7472bd526591e2192926247109dbf78692e709d3e56775792fec877a7720/uuid7-0.1.0.tar.gz", hash = "sha256:8c57aa32ee7456d3cc68c95c4530bc571646defac01895cfc73545449894a63c", size = 14052, upload-time = "2021-12-29T01:38:21.897Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b5/77/8852f89a91453956582a85024d80ad96f30a41fed4c2b3dce0c9f12ecc7e/uuid7-0.1.0-py2.py3-none-any.whl", hash = "sha256:5e259bb63c8cb4aded5927ff41b444a80d0c7124e8a0ced7cf44efa1f5cccf61", size = 7477, upload-time = "2021-12-29T01:38:20.418Z" },
+]
+
 [[package]]
 name = "uvicorn"
 version = "0.34.3"
@@ -1427,7 +1471,7 @@ wheels = [
 
 [[package]]
 name = "windows-mcp"
-version = "0.5.4"
+version = "0.5.7"
 source = { editable = "." }
 dependencies = [
     { name = "click" },
@@ -1439,14 +1483,17 @@ dependencies = [
     { name = "markdownify" },
     { name = "pdfplumber" },
     { name = "pillow" },
+    { name = "posthog" },
     { name = "psutil" },
     { name = "pyautogui" },
     { name = "pygetwindow" },
+    { name = "python-dotenv" },
     { name = "python-levenshtein" },
     { name = "pywinauto" },
     { name = "requests" },
     { name = "tabulate" },
     { name = "uiautomation" },
+    { name = "uuid7" },
 ]
 
 [package.metadata]
@@ -1456,18 +1503,21 @@ requires-dist = [
     { name = "fuzzywuzzy", specifier = ">=0.18.0" },
     { name = "humancursor", specifier = ">=1.1.5" },
     { name = "ipykernel", specifier = ">=6.30.0" },
-    { name = "live-inspect", specifier = ">=0.1.1" },
+    { name = "live-inspect", specifier = ">=0.1.2" },
     { name = "markdownify", specifier = ">=1.1.0" },
     { name = "pdfplumber", specifier = ">=0.11.7" },
     { name = "pillow", specifier = ">=11.2.1" },
+    { name = "posthog", specifier = ">=7.4.0" },
     { name = "psutil", specifier = ">=7.0.0" },
     { name = "pyautogui", specifier = ">=0.9.54" },
     { name = "pygetwindow", specifier = ">=0.0.9" },
+    { name = "python-dotenv", specifier = ">=1.1.0" },
     { name = "python-levenshtein", specifier = ">=0.27.1" },
     { name = "pywinauto", specifier = ">=0.6.9" },
     { name = "requests", specifier = ">=2.32.3" },
     { name = "tabulate", specifier = ">=0.9.0" },
     { name = "uiautomation", specifier = ">=2.0.24" },
+    { name = "uuid7", specifier = ">=0.1.0" },
 ]
 
 [[package]]