windows-mcp 0.5.3__py3-none-any.whl → 0.5.4__py3-none-any.whl

{windows_mcp-0.5.3.dist-info → windows_mcp-0.5.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windows-mcp
-Version: 0.5.3
+Version: 0.5.4
 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.dist-info → windows_mcp-0.5.4.dist-info}/RECORD

@@ -9,8 +9,8 @@ windows_mcp/tree/config.py,sha256=k-Mjo_yIn0d1AzcEW_bxiaXyBFxBZZSyy7hCNQ3XVp0,10
 windows_mcp/tree/service.py,sha256=KWdOHY5Q1HU-PJV6vMv_h9KVb5oL_E5vnAW-KICEzfw,24786
 windows_mcp/tree/utils.py,sha256=6hbxdIQPrAY-I3jcHsRqodHlxboTQj2GnLA71bf1lqY,911
 windows_mcp/tree/views.py,sha256=6A1bLGVt_MHPTvQt9kbUFoPpIqMI43JZjOSg-_o3ajk,3479
-windows_mcp-0.5.3.dist-info/METADATA,sha256=aMbmdQu1I-6gK58_Lyz3lA5ZfbzI9XXRUNwNwOaey7o,14541
-windows_mcp-0.5.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-windows_mcp-0.5.3.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
-windows_mcp-0.5.3.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
-windows_mcp-0.5.3.dist-info/RECORD,,
+windows_mcp-0.5.4.dist-info/METADATA,sha256=E8KB-mhjNa992NRPHAnl5r7nkCuAExc2cTPdrDhNuGY,13537
+windows_mcp-0.5.4.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+windows_mcp-0.5.4.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
+windows_mcp-0.5.4.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
+windows_mcp-0.5.4.dist-info/RECORD,,