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

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/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/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.dist-info → windows_mcp-0.5.7.dist-info}/METADATA

@@ -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.dist-info → windows_mcp-0.5.7.dist-info}/RECORD

@@ -1,16 +1,17 @@
 windows_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-windows_mcp/__main__.py,sha256=pkwexVikZwUFHe0oqmMYFfiRavjNfs5Bv-ELvLv9Dpo,11939
+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=97e2E4TdMs3TwW6CtupVxnwhWqdBKU5eH4MDz6_5Hmk,18469
+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.5.dist-info/METADATA,sha256=Jx7stv6_Lm145NSLB8EdAsRJsBXiP0FhIQ-7cA2FmEU,13537
-windows_mcp-0.5.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-windows_mcp-0.5.5.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
-windows_mcp-0.5.5.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
-windows_mcp-0.5.5.dist-info/RECORD,,
+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,,