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

{windows_mcp-0.5.3 → windows_mcp-0.5.5}/.gitignore

@@ -165,5 +165,5 @@ cython_debug/
 .mcpregistry_github_token
 .mcpregistry_registry_token
 sandbox
-# *.ipynb
+*.ipynb
 *.mcpb

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windows-mcp
-Version: 0.5.3
+Version: 0.5.5
 Summary: Lightweight MCP Server for interacting with Windows Operating System.
 Project-URL: homepage, https://github.com/CursorTouch
 Author-email: Jeomon George <jeogeoalukka@gmail.com>
@@ -75,7 +75,7 @@ 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 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`.
@@ -116,55 +116,6 @@ mcp-name: io.github.CursorTouch/Windows-MCP
 - **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.
 
-## 🌐 DOM Mode for Browser Automation
-
-Windows-MCP includes a powerful **DOM Mode** feature that enhances browser automation by focusing on web page content rather than browser UI elements.
-
-### What is DOM Mode?
-
-When `use_dom=True` is set in the State-Tool, the MCP server:
-- **Filters out browser UI**: Removes address bars, tabs, toolbars, and other browser chrome elements
-- **Returns only web content**: Provides interactive elements (links, buttons, forms) from the actual web page
-- **Reduces token usage**: Cleaner output means fewer tokens sent to the LLM
-- **Improves accuracy**: LLM focuses only on relevant web page elements
-
-### When to Use DOM Mode
-
-✅ **Use `use_dom=True` when:**
-- Automating web applications or websites
-- Scraping web content
-- Filling out web forms
-- Clicking links or buttons on web pages
-- Testing web interfaces
-- You want to ignore browser UI and focus on page content
-
-❌ **Use `use_dom=False` (default) when:**
-- Interacting with browser controls (address bar, tabs, bookmarks)
-- Working with desktop applications
-- Need to see all UI elements including browser chrome
-- Managing browser settings or extensions
-
-### Example Usage
-
-```python
-# Get web page content only (no browser UI)
-state_tool(use_vision=False, use_dom=True)
-
-# Get full desktop state including browser UI
-state_tool(use_vision=False, use_dom=False)
-
-# Get web page content with screenshot
-state_tool(use_vision=True, use_dom=True)
-```
-
-### Benefits
-
-1. **Token Efficiency**: Reduces the amount of data sent to LLM by filtering irrelevant browser UI
-2. **Better Focus**: LLM concentrates on actionable web page elements
-3. **Cleaner Output**: Only relevant interactive elements from the DOM are returned
-4. **Faster Processing**: Less data means faster LLM inference
-5. **Cost Savings**: Fewer tokens = lower API costs for cloud LLMs
-
 ## 🛠️Installation
 
 ### Prerequisites
@@ -182,23 +133,56 @@ state_tool(use_vision=True, use_dom=True)
 npm install -g @anthropic-ai/mcpb
 ```
 
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+  2. Configure the extension:
 
-cd Windows-MCP
-```
+  **Option A: Install from PyPI (Recommended)**
+  
+  Use `uvx` to run the latest version directly from PyPI.
+
+  Add this to your `claude_desktop_config.json`:
+  ```json
+  {
+    "mcpServers": {
+      "windows-mcp": {
+        "command": "uvx",
+        "args": [
+          "windows-mcp"
+        ]
+      }
+    }
+  }
+  ```
+
+  **Option B: Install from Source**
+
+  1. Clone the repository:
+  ```shell
+  git clone https://github.com/CursorTouch/Windows-MCP.git
+  cd Windows-MCP
+  ```
+
+  2. Add this to your `claude_desktop_config.json`:
+  ```json
+  {
+    "mcpServers": {
+      "windows-mcp": {
+        "command": "uv",
+        "args": [
+          "--directory",
+          "<path to the windows-mcp directory>",
+          "run",
+          "windows-mcp"
+        ]
+      }
+    }
+  }
+  ```
 
-  3. Build Desktop Extension `MCPB`:
 
-```shell
-npx @anthropic-ai/mcpb pack
-```
 
-  4. Open Claude Desktop:
+  3. Open Claude Desktop and enjoy! 🥳
 
-Go to `Settings->Extensions->Advance Settings->Install Extension` (locate the `.mcpb` file)-> Install
 
   5. Enjoy 🥳.
 
@@ -224,17 +208,32 @@ Go to `Settings->Connectors->Add Connector->Advanced`
 
   4. Enter the name as `Windows-MCP`, then paste the following JSON in the text area.
 
-```json
-{
-  "command": "uv",
-  "args": [
-    "--directory",
-    "<path to the windows-mcp directory>",
-    "run",
-    "main.py"
-  ]
-}
-```
+
+  **Option A: Install from PyPI (Recommended)**
+
+  ```json
+  {
+    "command": "uvx",
+    "args": [
+      "windows-mcp"
+    ]
+  }
+  ```
+
+  **Option B: Install from Source**
+
+  ```json
+  {
+    "command": "uv",
+    "args": [
+      "--directory",
+      "<path to the windows-mcp directory>",
+      "run",
+      "windows-mcp"
+    ]
+  }
+  ```
+
 
 5. Click `Save` and Enjoy 🥳.
 
@@ -250,13 +249,9 @@ For additional Claude Desktop integration troubleshooting, see the [Perplexity M
 npm install -g @google/gemini-cli
 ```
 
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+  2. Configure the server in `%USERPROFILE%/.gemini/settings.json`:
 
-cd Windows-MCP
-```
 
   3. Navigate to `%USERPROFILE%/.gemini` in File Explorer and open `settings.json`.
 
@@ -269,17 +264,16 @@ cd Windows-MCP
 //MCP Server Config
   "mcpServers": {
     "windows-mcp": {
-      "command": "uv",
+      "command": "uvx",
       "args": [
-        "--directory",
-        "<path to the windows-mcp directory>",
-        "run",
-        "main.py"
+        "windows-mcp"
       ]
     }
   }
 }
 ```
+*Note: To run from source, replace the command with `uv` and args with `["--directory", "<path>", "run", "windows-mcp"]`.*
+
 
   5. Rerun Gemini CLI in terminal. Enjoy 🥳
 </details>
@@ -291,13 +285,9 @@ cd Windows-MCP
 ```shell
 npm install -g @qwen-code/qwen-code@latest
 ```
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+   2. Configure the server in `%USERPROFILE%/.qwen/settings.json`:
 
-cd Windows-MCP
-```
 
   3. Navigate to `%USERPROFILE%/.qwen/settings.json`.
 
@@ -308,17 +298,16 @@ cd Windows-MCP
 //MCP Server Config
   "mcpServers": {
     "windows-mcp": {
-      "command": "uv",
+      "command": "uvx",
       "args": [
-        "--directory",
-        "<path to the windows-mcp directory>",
-        "run",
-        "main.py"
+        "windows-mcp"
       ]
     }
   }
 }
 ```
+*Note: To run from source, replace the command with `uv` and args with `["--directory", "<path>", "run", "windows-mcp"]`.*
+
 
   5. Rerun Qwen Code in terminal. Enjoy 🥳
 </details>
@@ -330,27 +319,22 @@ cd Windows-MCP
 ```shell
 npm install -g @openai/codex
 ```
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+  2. Configure the server in `%USERPROFILE%/.codex/config.toml`:
 
-cd Windows-MCP
-```
   3. Navigate to `%USERPROFILE%/.codex/config.toml`.
 
   4. Add the `windows-mcp` config in the `config.toml` and save it.
 
 ```toml
 [mcp_servers.windows-mcp]
-command="uv"
+command="uvx"
 args=[
-  "--directory",
-  "<path to the windows-mcp directory>",
-  "run",
-  "main.py"
+  "windows-mcp"
 ]
 ```
+*Note: To run from source, replace the command with `uv` and args with `["--directory", "<path>", "run", "windows-mcp"]`.*
+
 
   5. Rerun Codex CLI in terminal. Enjoy 🥳
 </details>

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

@@ -26,7 +26,7 @@
 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 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`.
@@ -67,55 +67,6 @@ mcp-name: io.github.CursorTouch/Windows-MCP
 - **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.
 
-## 🌐 DOM Mode for Browser Automation
-
-Windows-MCP includes a powerful **DOM Mode** feature that enhances browser automation by focusing on web page content rather than browser UI elements.
-
-### What is DOM Mode?
-
-When `use_dom=True` is set in the State-Tool, the MCP server:
-- **Filters out browser UI**: Removes address bars, tabs, toolbars, and other browser chrome elements
-- **Returns only web content**: Provides interactive elements (links, buttons, forms) from the actual web page
-- **Reduces token usage**: Cleaner output means fewer tokens sent to the LLM
-- **Improves accuracy**: LLM focuses only on relevant web page elements
-
-### When to Use DOM Mode
-
-✅ **Use `use_dom=True` when:**
-- Automating web applications or websites
-- Scraping web content
-- Filling out web forms
-- Clicking links or buttons on web pages
-- Testing web interfaces
-- You want to ignore browser UI and focus on page content
-
-❌ **Use `use_dom=False` (default) when:**
-- Interacting with browser controls (address bar, tabs, bookmarks)
-- Working with desktop applications
-- Need to see all UI elements including browser chrome
-- Managing browser settings or extensions
-
-### Example Usage
-
-```python
-# Get web page content only (no browser UI)
-state_tool(use_vision=False, use_dom=True)
-
-# Get full desktop state including browser UI
-state_tool(use_vision=False, use_dom=False)
-
-# Get web page content with screenshot
-state_tool(use_vision=True, use_dom=True)
-```
-
-### Benefits
-
-1. **Token Efficiency**: Reduces the amount of data sent to LLM by filtering irrelevant browser UI
-2. **Better Focus**: LLM concentrates on actionable web page elements
-3. **Cleaner Output**: Only relevant interactive elements from the DOM are returned
-4. **Faster Processing**: Less data means faster LLM inference
-5. **Cost Savings**: Fewer tokens = lower API costs for cloud LLMs
-
 ## 🛠️Installation
 
 ### Prerequisites
@@ -133,23 +84,56 @@ state_tool(use_vision=True, use_dom=True)
 npm install -g @anthropic-ai/mcpb
 ```
 
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+  2. Configure the extension:
 
-cd Windows-MCP
-```
+  **Option A: Install from PyPI (Recommended)**
+  
+  Use `uvx` to run the latest version directly from PyPI.
+
+  Add this to your `claude_desktop_config.json`:
+  ```json
+  {
+    "mcpServers": {
+      "windows-mcp": {
+        "command": "uvx",
+        "args": [
+          "windows-mcp"
+        ]
+      }
+    }
+  }
+  ```
+
+  **Option B: Install from Source**
+
+  1. Clone the repository:
+  ```shell
+  git clone https://github.com/CursorTouch/Windows-MCP.git
+  cd Windows-MCP
+  ```
+
+  2. Add this to your `claude_desktop_config.json`:
+  ```json
+  {
+    "mcpServers": {
+      "windows-mcp": {
+        "command": "uv",
+        "args": [
+          "--directory",
+          "<path to the windows-mcp directory>",
+          "run",
+          "windows-mcp"
+        ]
+      }
+    }
+  }
+  ```
 
-  3. Build Desktop Extension `MCPB`:
 
-```shell
-npx @anthropic-ai/mcpb pack
-```
 
-  4. Open Claude Desktop:
+  3. Open Claude Desktop and enjoy! 🥳
 
-Go to `Settings->Extensions->Advance Settings->Install Extension` (locate the `.mcpb` file)-> Install
 
   5. Enjoy 🥳.
 
@@ -175,17 +159,32 @@ Go to `Settings->Connectors->Add Connector->Advanced`
 
   4. Enter the name as `Windows-MCP`, then paste the following JSON in the text area.
 
-```json
-{
-  "command": "uv",
-  "args": [
-    "--directory",
-    "<path to the windows-mcp directory>",
-    "run",
-    "main.py"
-  ]
-}
-```
+
+  **Option A: Install from PyPI (Recommended)**
+
+  ```json
+  {
+    "command": "uvx",
+    "args": [
+      "windows-mcp"
+    ]
+  }
+  ```
+
+  **Option B: Install from Source**
+
+  ```json
+  {
+    "command": "uv",
+    "args": [
+      "--directory",
+      "<path to the windows-mcp directory>",
+      "run",
+      "windows-mcp"
+    ]
+  }
+  ```
+
 
 5. Click `Save` and Enjoy 🥳.
 
@@ -201,13 +200,9 @@ For additional Claude Desktop integration troubleshooting, see the [Perplexity M
 npm install -g @google/gemini-cli
 ```
 
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+  2. Configure the server in `%USERPROFILE%/.gemini/settings.json`:
 
-cd Windows-MCP
-```
 
   3. Navigate to `%USERPROFILE%/.gemini` in File Explorer and open `settings.json`.
 
@@ -220,17 +215,16 @@ cd Windows-MCP
 //MCP Server Config
   "mcpServers": {
     "windows-mcp": {
-      "command": "uv",
+      "command": "uvx",
       "args": [
-        "--directory",
-        "<path to the windows-mcp directory>",
-        "run",
-        "main.py"
+        "windows-mcp"
       ]
     }
   }
 }
 ```
+*Note: To run from source, replace the command with `uv` and args with `["--directory", "<path>", "run", "windows-mcp"]`.*
+
 
   5. Rerun Gemini CLI in terminal. Enjoy 🥳
 </details>
@@ -242,13 +236,9 @@ cd Windows-MCP
 ```shell
 npm install -g @qwen-code/qwen-code@latest
 ```
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+   2. Configure the server in `%USERPROFILE%/.qwen/settings.json`:
 
-cd Windows-MCP
-```
 
   3. Navigate to `%USERPROFILE%/.qwen/settings.json`.
 
@@ -259,17 +249,16 @@ cd Windows-MCP
 //MCP Server Config
   "mcpServers": {
     "windows-mcp": {
-      "command": "uv",
+      "command": "uvx",
       "args": [
-        "--directory",
-        "<path to the windows-mcp directory>",
-        "run",
-        "main.py"
+        "windows-mcp"
       ]
     }
   }
 }
 ```
+*Note: To run from source, replace the command with `uv` and args with `["--directory", "<path>", "run", "windows-mcp"]`.*
+
 
   5. Rerun Qwen Code in terminal. Enjoy 🥳
 </details>
@@ -281,27 +270,22 @@ cd Windows-MCP
 ```shell
 npm install -g @openai/codex
 ```
-  2. Clone the repository.
 
-```shell
-git clone https://github.com/CursorTouch/Windows-MCP.git
+  2. Configure the server in `%USERPROFILE%/.codex/config.toml`:
 
-cd Windows-MCP
-```
   3. Navigate to `%USERPROFILE%/.codex/config.toml`.
 
   4. Add the `windows-mcp` config in the `config.toml` and save it.
 
 ```toml
 [mcp_servers.windows-mcp]
-command="uv"
+command="uvx"
 args=[
-  "--directory",
-  "<path to the windows-mcp directory>",
-  "run",
-  "main.py"
+  "windows-mcp"
 ]
 ```
+*Note: To run from source, replace the command with `uv` and args with `["--directory", "<path>", "run", "windows-mcp"]`.*
+
 
   5. Rerun Codex CLI in terminal. Enjoy 🥳
 </details>

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

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

{windows_mcp-0.5.3 → windows_mcp-0.5.5}/server.json

@@ -13,7 +13,7 @@
       "registry_type": "pypi",
       "registry_base_url": "https://pypi.org",
       "identifier": "windows_mcp",
-      "version": "0.5.0",
+      "version": "0.5.4",
       "runtime_hint": "uvx",
       "transport": {
         "type": "stdio"

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

@@ -243,10 +243,10 @@ def wait_tool(duration:int)->str:
 def scrape_tool(url:str)->str:
     desktop_state=desktop.desktop_state
     tree_state=desktop_state.tree_state
-    if not tree_state.dom_node:
-        return f'Unable to scrape URL: {url}. No DOM node found.'
-    dom_node=tree_state.dom
-    vertical_scroll_percent=dom_node.vertical_scroll_percent
+    if not tree_state.dom_info:
+        return f'No DOM information found. Please open {url} in browser first.'
+    dom_info=tree_state.dom_info
+    vertical_scroll_percent=dom_info.vertical_scroll_percent
     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"