windows-mcp 0.6.0__tar.gz → 0.6.2__tar.gz

windows_mcp-0.6.2/.mcpbignore

@@ -0,0 +1,22 @@
+# Virtual environment (uses uv run at runtime)
+.venv/
+
+# Demo videos (too large for bundle)
+assets/demo*.mov
+assets/*.mov
+
+# Git
+.git/
+
+# Development files
+__pycache__/
+*.pyc
+.pytest_cache/
+
+# Editor files
+.vscode/
+.idea/
+*.swp
+
+# State files from audit
+.clone-and-audit-state.json

{windows_mcp-0.6.0 → windows_mcp-0.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windows-mcp
-Version: 0.6.0
+Version: 0.6.2
 Summary: Lightweight MCP Server for interacting with Windows Operating System.
 Project-URL: homepage, https://github.com/CursorTouch
 Author-email: Jeomon George <jeogeoalukka@gmail.com>
@@ -73,7 +73,9 @@ Description-Content-Type: text/markdown
 mcp-name: io.github.CursorTouch/Windows-MCP
 
 ## Updates
-- Windows-MCP reached 1M+ Users in [Claude Desktop Extensiosn](https://claude.ai/directory). 
+- v0.6.2: Extended boolean parameter compatibility and updated `manifest.json` for `mcpb` compatibility in Claude Desktop (Thanks to bryan-anthropic).
+- v0.6.1: Fixed `Shell` tool output issues and improved boolean parameter compatibility (Thanks to @yakub268).
+- 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.
@@ -110,7 +112,7 @@ 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.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.
+  Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.2 to 0.9 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.
@@ -347,8 +349,7 @@ MCP Client can access the following tools to interact with Windows:
 - `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.
+- `Move`: Move mouse pointer or drag (set drag=True) to coordinates.
 - `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.

{windows_mcp-0.6.0 → windows_mcp-0.6.2}/README.md

@@ -26,7 +26,9 @@
 mcp-name: io.github.CursorTouch/Windows-MCP
 
 ## Updates
-- Windows-MCP reached 1M+ Users in [Claude Desktop Extensiosn](https://claude.ai/directory). 
+- v0.6.2: Extended boolean parameter compatibility and updated `manifest.json` for `mcpb` compatibility in Claude Desktop (Thanks to bryan-anthropic).
+- v0.6.1: Fixed `Shell` tool output issues and improved boolean parameter compatibility (Thanks to @yakub268).
+- 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.
@@ -63,7 +65,7 @@ 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.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.
+  Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.2 to 0.9 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.
@@ -300,8 +302,7 @@ MCP Client can access the following tools to interact with Windows:
 - `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.
+- `Move`: Move mouse pointer or drag (set drag=True) to coordinates.
 - `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.

windows_mcp-0.6.2/manifest.json

@@ -0,0 +1,114 @@
+{
+  "manifest_version": "0.2",
+  "name": "Windows-MCP",
+  "version": "0.6.2",
+  "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, it bridges the gap between large language models (LLMs) and the Windows OS, allowing agents to perform tasks such as **file navigation, application control, UI interaction, QA testing, and more**.\n\n**KEY FEATURES**\n- **Seamless Windows Integration**: Interacts natively with Windows UI elements, opens applications, controls windows, simulates user input, and more.\n- **Use Any LLM (Vision Optional)**: Does not rely on traditional computer vision techniques or fine-tuned models. Works with any LLM, reducing complexity and setup time.\n- **Rich Toolset for UI Automation**: Includes tools for keyboard and mouse control, window management, and capturing window or UI state.\n- **Lightweight & Open-Source**: Minimal dependencies with full source code available under the MIT license.\n- **Customizable & Extendable**: Easily adapt or extend tools to suit custom automation workflows or AI integrations.\n- **Real-Time Interaction**: Typical latency between actions ranges from `0.2` to `0.9` seconds, depending on system load, active applications, and LLM inference speed.\n\n**MINIMUM REQUIREMENTS**\n- Python 3.13 or higher\n- UV Package Manager\nThis MCP server requires UV, a fast Python package manager.\nInstallation:\n`curl -LsSf https://astral.sh/uv/install.sh | sh`\nFor detailed installation instructions, [see the UV documentation](https://github.com/astral-sh/uv)",
+  "author": {
+    "name": "CursorTouch",
+    "url": "https://cursortouch.com/"
+  },
+  "homepage": "https://cursortouch.com/",
+  "documentation": "https://github.com/CursorTouch/Windows-MCP",
+  "icon": "assets/logo.png",
+  "screenshots": [
+    "assets/screenshots/screenshot_1.png",
+    "assets/screenshots/screenshot_2.png",
+    "assets/screenshots/screenshot_3.png"
+  ],
+  "server": {
+    "type": "python",
+    "entry_point": "./src/windows_mcp/__main__.py",
+    "mcp_config": {
+      "command": "uv",
+      "args": [
+        "--directory",
+        "${__dirname}",
+        "run",
+        "windows-mcp"
+      ],
+      "env": {
+        "ANONYMIZED_TELEMETRY": "${user_config.anonymized_telemetry}"
+      }
+    }
+  },
+  "user_config": {
+    "anonymized_telemetry": {
+      "type": "boolean",
+      "title": "Anonymized Telemetry",
+      "description": "Windows-MCP collects basic usage data to help improve the MCP server. No personal information, tool arguments, or tool outputs are tracked.",
+      "required": false,
+      "default": true
+    }
+  },
+  "tools": [
+    {
+      "name": "App",
+      "description": "Manages Windows applications with three modes: 'launch' (opens the prescibed application), 'resize' (adjusts active window size/position), 'switch' (brings specific window into focus)."
+    },
+    {
+      "name": "Shell",
+      "description": "A comprehensive system tool for executing any PowerShell commands. Use it to navigate the file system, manage files and processes, and execute system-level operations. Capable of accessing web content, interacting with network resources, and performing complex administrative tasks."
+    },
+    {
+      "name": "Snapshot",
+      "description": "Captures complete desktop state including: system language, focused/opened windows, interactive elements (buttons, text fields, links, menus with coordinates), and scrollable areas. Set use_vision=True to include screenshot. Set use_dom=True for browser content to get web page elements instead of browser UI. Always call this first to understand the current desktop state before taking actions."
+    },
+    {
+      "name": "Click",
+      "description": "Performs mouse clicks at specified coordinates [x, y]. Supports button types: 'left' for selection/activation, 'right' for context menus, 'middle'. Supports clicks: 0=hover only (no click), 1=single click (select/focus), 2=double click (open/activate)."
+    },
+    {
+      "name": "Type",
+      "description": "Types text at specified coordinates [x, y]. Set clear=True to clear existing text first, False to append. Set press_enter=True to submit after typing. Set caret_position to 'start' (beginning), 'end' (end), or 'idle' (default)."
+    },
+    {
+      "name": "Scroll",
+      "description": "Scrolls at coordinates [x, y] or current mouse position if loc=None. Type: vertical (default) or horizontal. Direction: up/down for vertical, left/right for horizontal. wheel_times controls amount (1 wheel ≈ 3-5 lines). Use for navigating long content, lists, and web pages."
+    },
+    {
+      "name": "Move",
+      "description": "Moves mouse cursor to coordinates [x, y]. Set drag=True to perform a drag-and-drop operation from the current mouse position to the target coordinates. Default (drag=False) is a simple cursor move (hover)."
+    },
+    {
+      "name": "Shortcut",
+      "description": "Executes keyboard shortcuts using key combinations separated by +. Examples: \"ctrl+c\" (copy), \"ctrl+v\" (paste), \"alt+tab\" (switch apps), \"win+r\" (Run dialog), \"win\" (Start menu), \"ctrl+shift+esc\" (Task Manager). Use for quick actions and system commands."
+    },
+    {
+      "name": "Wait",
+      "description": "Pauses execution for specified duration in seconds. Use when waiting for: applications to launch/load, UI animations to complete, page content to render, dialogs to appear, or between rapid actions. Helps ensure UI is ready before next interaction."
+    },
+    {
+      "name": "Scrape",
+      "description": "Fetch content from a URL or the active browser tab. By default, performs a lightweight HTTP request to the URL. If you need to extract text from the active tab's DOM within the viewport, ensure the page is open in a browser and use Snapshot with use_dom=True first, then the agent will handle extraction."
+    },
+    {
+      "name": "MultiSelect",
+      "description": "Selects multiple items such as files, folders, or checkboxes if press_ctrl=True, or performs multiple clicks if False."
+    },
+    {
+      "name": "MultiEdit",
+      "description": "Enters text into multiple input fields at specified coordinates [[x,y,text], ...]."
+    }
+  ],
+  "compatibility": {
+    "platforms": [
+      "win32"
+    ],
+    "runtimes": {
+      "python": ">=3.13"
+    }
+  },
+  "keywords": [
+    "windows",
+    "automation",
+    "ai",
+    "mcp",
+    "computer-use"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CursorTouch/Windows-MCP"
+  }
+}

{windows_mcp-0.6.0 → windows_mcp-0.6.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "windows-mcp"
-version = "0.6.0"
+version = "0.6.2"
 description = "Lightweight MCP Server for interacting with Windows Operating System."
 authors = [
     { name = "Jeomon George", email = "jeogeoalukka@gmail.com" }

{windows_mcp-0.6.0 → windows_mcp-0.6.2}/server.json

@@ -12,8 +12,8 @@
     {
       "registry_type": "pypi",
       "registry_base_url": "https://pypi.org",
-      "identifier": "windows_mcp",
-      "version": "0.5.4",
+      "identifier": "windows-mcp",
+      "version": "0.6.2",
       "runtime_hint": "uvx",
       "transport": {
         "type": "stdio"

{windows_mcp-0.6.0 → windows_mcp-0.6.2}/src/windows_mcp/__main__.py

@@ -56,7 +56,7 @@ mcp=FastMCP(name='windows-mcp',instructions=instructions,lifespan=lifespan)
 
 @mcp.tool(
     name="App",
-    description="Manages Windows applications with three modes: 'launch' (start app by name), 'resize' (set window position/size using window_loc=[x,y] and window_size=[width,height]), 'switch' (activate app by name). Essential for application lifecycle management.",
+    description="Manages Windows applications with three modes: 'launch' (opens the prescibed application), 'resize' (adjusts active window size/position), 'switch' (brings specific window into focus).",
     annotations=ToolAnnotations(
         title="App",
         readOnlyHint=False,
@@ -87,7 +87,7 @@ def powershell_tool(command: str,timeout:int=10, ctx: Context = None) -> str:
 
 @mcp.tool(
     name='Snapshot',
-    description='Captures complete desktop state including: system language, focused/opened apps, interactive elements (buttons, text fields, links, menus with coordinates), and scrollable areas. Set use_vision=True to include screenshot. Set use_dom=True for browser content to get web page elements instead of browser UI. Always call this first to understand the current desktop state before taking actions.',
+    description='Captures complete desktop state including: system language, focused/opened windows, interactive elements (buttons, text fields, links, menus with coordinates), and scrollable areas. Set use_vision=True to include screenshot. Set use_dom=True for browser content to get web page elements instead of browser UI. Always call this first to understand the current desktop state before taking actions.',
     annotations=ToolAnnotations(
         title="Snapshot",
         readOnlyHint=True,
@@ -97,7 +97,10 @@ def powershell_tool(command: str,timeout:int=10, ctx: Context = None) -> str:
     )
     )
 @with_analytics(analytics, "State-Tool")
-def state_tool(use_vision:bool=False,use_dom:bool=False, ctx: Context = None):
+def state_tool(use_vision:bool|str=False,use_dom:bool|str=False, ctx: Context = None):
+    use_vision = use_vision is True or (isinstance(use_vision, str) and use_vision.lower() == 'true')
+    use_dom = use_dom is True or (isinstance(use_dom, str) and use_dom.lower() == 'true')
+    
     # Calculate scale factor to cap resolution at 1080p (1920x1080)
     scale_width = MAX_IMAGE_WIDTH / screen_size.width if screen_size.width > MAX_IMAGE_WIDTH else 1.0
     scale_height = MAX_IMAGE_HEIGHT / screen_size.height if screen_size.height > MAX_IMAGE_HEIGHT else 1.0
@@ -106,14 +109,22 @@ def state_tool(use_vision:bool=False,use_dom:bool=False, ctx: Context = None):
     desktop_state=desktop.get_state(use_vision=use_vision,use_dom=use_dom,as_bytes=True,scale=scale)
     interactive_elements=desktop_state.tree_state.interactive_elements_to_string()
     scrollable_elements=desktop_state.tree_state.scrollable_elements_to_string()
-    apps=desktop_state.apps_to_string()
-    active_app=desktop_state.active_app_to_string()
-    return [dedent(f'''        
-    Focused App:
-    {active_app}
+    windows=desktop_state.windows_to_string()
+    active_window=desktop_state.active_window_to_string()
+    active_desktop=desktop_state.active_desktop_to_string()
+    all_desktops=desktop_state.desktops_to_string()
+    return [dedent(f'''
+    Active Desktop:
+    {active_desktop}
+
+    All Desktops:
+    {all_desktops}
+        
+    Focused Window:
+    {active_window}
 
-    Opened Apps:
-    {apps}
+    Opened Windows:
+    {windows}
 
     List of Interactive Elements:
     {interactive_elements or 'No interactive elements found.'}
@@ -124,7 +135,7 @@ def state_tool(use_vision:bool=False,use_dom:bool=False, ctx: Context = None):
 
 @mcp.tool(
     name='Click',
-    description='Performs mouse clicks at specified coordinates [x, y]. Supports button types: left (default), right (context menu), middle. Supports clicks: 1 (single), 2 (double), 3 (triple). Always use coordinates from State-Tool output to ensure accuracy.',
+    description="Performs mouse clicks at specified coordinates [x, y]. Supports button types: 'left' for selection/activation, 'right' for context menus, 'middle'. Supports clicks: 0=hover only (no click), 1=single click (select/focus), 2=double click (open/activate).",
     annotations=ToolAnnotations(
         title="Click",
         readOnlyHint=False,
@@ -139,12 +150,12 @@ def click_tool(loc:list[int],button:Literal['left','right','middle']='left',clic
         raise ValueError("Location must be a list of exactly 2 integers [x, y]")
     x,y=loc[0],loc[1]
     desktop.click(loc=loc,button=button,clicks=clicks)
-    num_clicks={1:'Single',2:'Double',3:'Triple'}
+    num_clicks={0:'Hover',1:'Single',2:'Double'}
     return f'{num_clicks.get(clicks)} {button} clicked at ({x},{y}).'
 
 @mcp.tool(
     name='Type',
-    description='Types text at specified coordinates [x, y]. Set clear=True to clear existing text first (Ctrl+A then type), clear=False to append. Set press_enter=True to submit after typing. Always click on the target input field first to ensure focus.',
+    description="Types text at specified coordinates [x, y]. Set clear=True to clear existing text first, False to append. Set press_enter=True to submit after typing. Set caret_position to 'start' (beginning), 'end' (end), or 'idle' (default).",
     annotations=ToolAnnotations(
         title="Type",
         readOnlyHint=False,
@@ -154,11 +165,11 @@ def click_tool(loc:list[int],button:Literal['left','right','middle']='left',clic
     )
     )
 @with_analytics(analytics, "Type-Tool")
-def type_tool(loc:list[int],text:str,clear:bool=False,press_enter:bool=False, ctx: Context = None)->str:
+def type_tool(loc:list[int],text:str,clear:bool|str=False,caret_position:Literal['start', 'idle', 'end']='idle',press_enter:bool|str=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]
-    desktop.type(loc=loc,text=text,clear=clear,press_enter=press_enter)
+    desktop.type(loc=loc,text=text,caret_position=caret_position,clear=clear,press_enter=press_enter)
     return f'Typed {text} at ({x},{y}).'
 
 @mcp.tool(
@@ -193,7 +204,8 @@ def scroll_tool(loc:list[int]=None,type:Literal['horizontal','vertical']='vertic
     )
     )
 @with_analytics(analytics, "Move-Tool")
-def move_tool(loc:list[int], drag:bool=False, ctx: Context = None)->str:
+def move_tool(loc:list[int], drag:bool|str=False, ctx: Context = None)->str:
+    drag = drag is True or (isinstance(drag, str) and drag.lower() == 'true')
     if len(loc) != 2:
         raise ValueError("loc must be a list of exactly 2 integers [x, y]")
     x,y=loc[0],loc[1]
@@ -248,7 +260,8 @@ def wait_tool(duration:int, ctx: Context = None)->str:
     )
     )
 @with_analytics(analytics, "Scrape-Tool")
-def scrape_tool(url:str,use_dom:bool=False, ctx: Context = None)->str:
+def scrape_tool(url:str,use_dom:bool|str=False, ctx: Context = None)->str:
+    use_dom = use_dom is True or (isinstance(use_dom, str) and use_dom.lower() == 'true')
     if not use_dom:
         content=desktop.scrape(url)
         return f'URL:{url}\nContent:\n{content}'
@@ -262,7 +275,42 @@ def scrape_tool(url:str,use_dom:bool=False, ctx: Context = None)->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}'
+
+@mcp.tool(
+    name='MultiSelect',
+    description="Selects multiple items such as files, folders, or checkboxes if press_ctrl=True, or performs multiple clicks if False.",
+    annotations=ToolAnnotations(
+        title="MultiSelect",
+        readOnlyHint=False,
+        destructiveHint=True,
+        idempotentHint=False,
+        openWorldHint=False
+    )
+)
+@with_analytics(analytics, "Multi-Select-Tool")
+def multi_select_tool(locs:list[list[int]], press_ctrl:bool|str=True, ctx: Context = None)->str:
+    press_ctrl = press_ctrl is True or (isinstance(press_ctrl, str) and press_ctrl.lower() == 'true')
+    desktop.multi_select(press_ctrl,locs)
+    elements_str = '\n'.join([f"({loc[0]},{loc[1]})" for loc in locs])
+    return f"Multi-selected elements at:\n{elements_str}"
+
+@mcp.tool(
+    name='MultiEdit',
+    description="Enters text into multiple input fields at specified coordinates [[x,y,text], ...].",
+    annotations=ToolAnnotations(
+        title="MultiEdit",
+        readOnlyHint=False,
+        destructiveHint=True,
+        idempotentHint=False,
+        openWorldHint=False
+    )
+)
+@with_analytics(analytics, "Multi-Edit-Tool")
+def multi_edit_tool(locs:list[list], ctx: Context = None)->str:
+    desktop.multi_edit(locs)
+    elements_str = ', '.join([f"({e[0]},{e[1]}) with text '{e[2]}'" for e in locs])
+    return f"Multi-edited elements at: {elements_str}"
 
 
 @click.command()