windows-mcp 0.5.8__py3-none-any.whl → 0.6.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- windows_mcp/__main__.py +299 -314
- windows_mcp/analytics.py +0 -5
- windows_mcp/desktop/service.py +638 -458
- windows_mcp/desktop/views.py +7 -5
- windows_mcp/tree/cache_utils.py +126 -0
- windows_mcp/tree/config.py +25 -0
- windows_mcp/tree/service.py +543 -601
- windows_mcp/tree/views.py +142 -116
- windows_mcp/uia/controls.py +11 -2
- windows_mcp/uia/core.py +9 -0
- windows_mcp/vdm/__init__.py +1 -0
- windows_mcp/vdm/core.py +490 -0
- windows_mcp/watchdog/event_handlers.py +13 -9
- windows_mcp/watchdog/service.py +15 -4
- {windows_mcp-0.5.8.dist-info → windows_mcp-0.6.0.dist-info}/METADATA +27 -21
- windows_mcp-0.6.0.dist-info/RECORD +29 -0
- windows_mcp-0.5.8.dist-info/RECORD +0 -26
- {windows_mcp-0.5.8.dist-info → windows_mcp-0.6.0.dist-info}/WHEEL +0 -0
- {windows_mcp-0.5.8.dist-info → windows_mcp-0.6.0.dist-info}/entry_points.txt +0 -0
- {windows_mcp-0.5.8.dist-info → windows_mcp-0.6.0.dist-info}/licenses/LICENSE.md +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: windows-mcp
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.6.0
|
|
4
4
|
Summary: Lightweight MCP Server for interacting with Windows Operating System.
|
|
5
5
|
Project-URL: homepage, https://github.com/CursorTouch
|
|
6
6
|
Author-email: Jeomon George <jeogeoalukka@gmail.com>
|
|
@@ -29,20 +29,17 @@ License-File: LICENSE.md
|
|
|
29
29
|
Keywords: ai,ai agent,desktop,mcp,windows
|
|
30
30
|
Requires-Python: >=3.13
|
|
31
31
|
Requires-Dist: click>=8.2.1
|
|
32
|
+
Requires-Dist: comtypes>=1.4.15
|
|
32
33
|
Requires-Dist: fastmcp>=2.14.2
|
|
33
34
|
Requires-Dist: fuzzywuzzy>=0.18.0
|
|
34
|
-
Requires-Dist: humancursor>=1.1.5
|
|
35
|
-
Requires-Dist: ipykernel>=6.30.0
|
|
36
35
|
Requires-Dist: markdownify>=1.1.0
|
|
37
|
-
Requires-Dist: pdfplumber>=0.11.7
|
|
38
36
|
Requires-Dist: pillow>=11.2.1
|
|
39
37
|
Requires-Dist: posthog>=7.4.0
|
|
40
38
|
Requires-Dist: psutil>=7.0.0
|
|
41
39
|
Requires-Dist: pyautogui>=0.9.54
|
|
42
|
-
Requires-Dist: pygetwindow>=0.0.9
|
|
43
40
|
Requires-Dist: python-dotenv>=1.1.0
|
|
44
41
|
Requires-Dist: python-levenshtein>=0.27.1
|
|
45
|
-
Requires-Dist:
|
|
42
|
+
Requires-Dist: pywin32>=311
|
|
46
43
|
Requires-Dist: requests>=2.32.3
|
|
47
44
|
Requires-Dist: tabulate>=0.9.0
|
|
48
45
|
Requires-Dist: uuid7>=0.1.0
|
|
@@ -76,7 +73,8 @@ Description-Content-Type: text/markdown
|
|
|
76
73
|
mcp-name: io.github.CursorTouch/Windows-MCP
|
|
77
74
|
|
|
78
75
|
## Updates
|
|
79
|
-
- Windows-MCP
|
|
76
|
+
- Windows-MCP reached 1M+ Users in [Claude Desktop Extensiosn](https://claude.ai/directory).
|
|
77
|
+
- Windows-MCP is now available on [PyPI](https://pypi.org/project/windows-mcp/) (thus supports `uvx windows-mcp`)
|
|
80
78
|
- Windows-MCP is added to [MCP Registry](https://github.com/modelcontextprotocol/registry)
|
|
81
79
|
- Try out 🪟[Windows-Use](https://github.com/CursorTouch/Windows-Use)!!, an agent built using Windows-MCP.
|
|
82
80
|
- Windows-MCP is now featured as Desktop Extension in `Claude Desktop`.
|
|
@@ -112,13 +110,15 @@ mcp-name: io.github.CursorTouch/Windows-MCP
|
|
|
112
110
|
Easily adapt or extend tools to suit your unique automation or AI integration needs.
|
|
113
111
|
|
|
114
112
|
- **Real-Time Interaction**
|
|
115
|
-
Typical latency between actions (e.g., from one mouse click to the next) ranges from **0.
|
|
113
|
+
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.
|
|
116
114
|
|
|
117
115
|
- **DOM Mode for Browser Automation**
|
|
118
116
|
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.
|
|
119
117
|
|
|
120
118
|
## 🛠️Installation
|
|
121
119
|
|
|
120
|
+
**Note:** When you install this MCP server for the first time it may take a minute or two because of installing the dependencies in `pyproject.toml`. In the first run the server may timeout ignore it and restart it.
|
|
121
|
+
|
|
122
122
|
### Prerequisites
|
|
123
123
|
|
|
124
124
|
- Python 3.13+
|
|
@@ -344,17 +344,17 @@ args=[
|
|
|
344
344
|
|
|
345
345
|
MCP Client can access the following tools to interact with Windows:
|
|
346
346
|
|
|
347
|
-
- `Click
|
|
348
|
-
- `Type
|
|
349
|
-
- `Scroll
|
|
350
|
-
- `Drag
|
|
351
|
-
- `Move
|
|
352
|
-
- `Shortcut
|
|
353
|
-
- `Wait
|
|
354
|
-
- `
|
|
355
|
-
- `App
|
|
356
|
-
- `Shell
|
|
357
|
-
- `Scrape
|
|
347
|
+
- `Click`: Click on the screen at the given coordinates.
|
|
348
|
+
- `Type`: Type text on an element (optionally clears existing text).
|
|
349
|
+
- `Scroll`: Scroll vertically or horizontally on the window or specific regions.
|
|
350
|
+
- `Drag`: Drag from one point to another.
|
|
351
|
+
- `Move`: Move mouse pointer.
|
|
352
|
+
- `Shortcut`: Press keyboard shortcuts (`Ctrl+c`, `Alt+Tab`, etc).
|
|
353
|
+
- `Wait`: Pause for a defined duration.
|
|
354
|
+
- `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.
|
|
355
|
+
- `App`: To launch an application from the start menu, resize or move the window and switch between apps.
|
|
356
|
+
- `Shell`: To execute PowerShell commands.
|
|
357
|
+
- `Scrape`: To scrape the entire webpage for information.
|
|
358
358
|
|
|
359
359
|
## 🤝 Connect with Us
|
|
360
360
|
Stay updated and join our community:
|
|
@@ -367,9 +367,15 @@ Stay updated and join our community:
|
|
|
367
367
|
|
|
368
368
|
[](https://www.star-history.com/#CursorTouch/Windows-MCP&Date)
|
|
369
369
|
|
|
370
|
-
##
|
|
370
|
+
## 👥 Contributors
|
|
371
|
+
|
|
372
|
+
Thanks to all the amazing people who have contributed to Windows-MCP! 🎉
|
|
373
|
+
|
|
374
|
+
<a href="https://github.com/CursorTouch/Windows-MCP/graphs/contributors">
|
|
375
|
+
<img src="https://contrib.rocks/image?repo=CursorTouch/Windows-MCP" />
|
|
376
|
+
</a>
|
|
371
377
|
|
|
372
|
-
|
|
378
|
+
We appreciate every contribution, whether it's code, documentation, bug reports, or feature suggestions. Want to contribute? Check out our [Contributing Guidelines](CONTRIBUTING)!
|
|
373
379
|
|
|
374
380
|
## 🔒 Security
|
|
375
381
|
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
windows_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
2
|
+
windows_mcp/__main__.py,sha256=fWKa82Rp-xbsfpiEHKkv0C4AckKI7Rz6flE11qxirIY,12993
|
|
3
|
+
windows_mcp/analytics.py,sha256=yir5IWAI_YN9dmy9KOVIRYsZbeAO12INcxvY2WJSWCU,6307
|
|
4
|
+
windows_mcp/desktop/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
5
|
+
windows_mcp/desktop/config.py,sha256=LxMWSyYOUfMKzkk5ts46dV1NrAnukS2zHjTfyEKRc-A,364
|
|
6
|
+
windows_mcp/desktop/service.py,sha256=oT0fDW-uz3p3xdexPS88Y5PvTkfrLwa5boW_sFkJl7M,26142
|
|
7
|
+
windows_mcp/desktop/views.py,sha256=5EEeG4aPDFPqxx0Fhs8ejfHC-eC7Bt2ezOYpOerVBwM,1578
|
|
8
|
+
windows_mcp/tree/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
9
|
+
windows_mcp/tree/cache_utils.py,sha256=xuS4Gt96Az8eYoo9cu464NRZWuGQngDCgAhT2iYX-j8,5361
|
|
10
|
+
windows_mcp/tree/config.py,sha256=2UbH76pA5VdlbFQ8-PCog-MoGxLmk5Pv1mvfAAg_9HQ,1496
|
|
11
|
+
windows_mcp/tree/service.py,sha256=KWFfH8Setzf0YAO1S4sVcMsRHbpQamD5_tba8rUdEz0,30518
|
|
12
|
+
windows_mcp/tree/utils.py,sha256=YaUqg_pK4pnii0Idzo0bwYcf7Xo3FQsxzwGNL7Qh1L4,893
|
|
13
|
+
windows_mcp/tree/views.py,sha256=OHxjuF2FpxdSZeD6CIO0Ec64jaZSEBXIH_dcvmq0CmA,4794
|
|
14
|
+
windows_mcp/uia/__init__.py,sha256=ePdeJOHmTihMedolZUEL59nKDXsBVyofT80miP_5G-Y,93
|
|
15
|
+
windows_mcp/uia/controls.py,sha256=xIRMJkktj0UzTeaxPO8g51aBV8Y9wL_EbrUZt77SgQY,223941
|
|
16
|
+
windows_mcp/uia/core.py,sha256=sgtzb8QmevNWuv_nORF3F_wU97TxCjZWZlpYPYWcoS8,132131
|
|
17
|
+
windows_mcp/uia/enums.py,sha256=DYcypTL8zkygdjZUezE2jgz9RMBM9AWe8ofvubLHRCg,83577
|
|
18
|
+
windows_mcp/uia/events.py,sha256=9Xwcn-X1dy2t6WlbwDsIedcKq1SIIHGZ183qpohfFBk,4726
|
|
19
|
+
windows_mcp/uia/patterns.py,sha256=CShOYqYMv7wdwDpNYZZZU3WZuLMvYhAAmnbzQ2Hx7aA,102692
|
|
20
|
+
windows_mcp/vdm/__init__.py,sha256=nE8jJjGJaKuJKCyuf6QLfrj8xPj8IqGKeH2VXP3FMzY,21
|
|
21
|
+
windows_mcp/vdm/core.py,sha256=OQFgkmt-hscUJc-fzBOS_klmCiax-wSTPRaX3TNDJbQ,21404
|
|
22
|
+
windows_mcp/watchdog/__init__.py,sha256=ExC350_KZXwTENsLQfESSPUJZfwsEjrAvGtLRPCqqjk,31
|
|
23
|
+
windows_mcp/watchdog/event_handlers.py,sha256=mHw2msgAjkGuYwTp-U6tYX-gL4S7N1J1HQNmyQ-sdVk,2052
|
|
24
|
+
windows_mcp/watchdog/service.py,sha256=9Tpoq8Ma3MF0Zq7yJKkLOx8NCm4bcUeJY_P1GPkjeLk,9099
|
|
25
|
+
windows_mcp-0.6.0.dist-info/METADATA,sha256=SRdaZCT4Iv88iA_Etok5itWAgHfWmiFxpDY2KVbqDp4,14545
|
|
26
|
+
windows_mcp-0.6.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
|
|
27
|
+
windows_mcp-0.6.0.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
|
|
28
|
+
windows_mcp-0.6.0.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
|
|
29
|
+
windows_mcp-0.6.0.dist-info/RECORD,,
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
windows_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
2
|
-
windows_mcp/__main__.py,sha256=2BMIGyyXCrWP-gz7xlq6ra4eQpcRK__oUQ1ao30frrQ,13013
|
|
3
|
-
windows_mcp/analytics.py,sha256=aRzVcGVE--veRnScs9i99upUGlIThEIo5_uKcsjoeRY,6428
|
|
4
|
-
windows_mcp/desktop/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
5
|
-
windows_mcp/desktop/config.py,sha256=LxMWSyYOUfMKzkk5ts46dV1NrAnukS2zHjTfyEKRc-A,364
|
|
6
|
-
windows_mcp/desktop/service.py,sha256=LwWmhSkKPFu-HrN9HdHoufI1KgoutDh0S11fAYQdVUg,18032
|
|
7
|
-
windows_mcp/desktop/views.py,sha256=8zdYAuq7LqO0hpsjNNyjoeVMwUUbvCTsyU8Z1sLCh08,1466
|
|
8
|
-
windows_mcp/tree/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
9
|
-
windows_mcp/tree/config.py,sha256=p0z9Nz5-OMztz7q_f5Q9nqkALL6JnibSPh35HZF039k,960
|
|
10
|
-
windows_mcp/tree/service.py,sha256=aAcRWDPQn9o3eH5NdJYZpo5b6ToEQgCWNsBzz52dOYI,31625
|
|
11
|
-
windows_mcp/tree/utils.py,sha256=YaUqg_pK4pnii0Idzo0bwYcf7Xo3FQsxzwGNL7Qh1L4,893
|
|
12
|
-
windows_mcp/tree/views.py,sha256=mh-Ls__Mj7YFy8GRGkpA8L9i4WYI9PcxCt_eOc2VplQ,3484
|
|
13
|
-
windows_mcp/uia/__init__.py,sha256=ePdeJOHmTihMedolZUEL59nKDXsBVyofT80miP_5G-Y,93
|
|
14
|
-
windows_mcp/uia/controls.py,sha256=p_H61k_9vSME6Qgvwah0aJhY6azrISmh676fNOlokOc,223625
|
|
15
|
-
windows_mcp/uia/core.py,sha256=0JUl1IXu7qOPVytuYRLMlMwMRrhJT8yjwtYwnnDycTI,131691
|
|
16
|
-
windows_mcp/uia/enums.py,sha256=DYcypTL8zkygdjZUezE2jgz9RMBM9AWe8ofvubLHRCg,83577
|
|
17
|
-
windows_mcp/uia/events.py,sha256=9Xwcn-X1dy2t6WlbwDsIedcKq1SIIHGZ183qpohfFBk,4726
|
|
18
|
-
windows_mcp/uia/patterns.py,sha256=CShOYqYMv7wdwDpNYZZZU3WZuLMvYhAAmnbzQ2Hx7aA,102692
|
|
19
|
-
windows_mcp/watchdog/__init__.py,sha256=ExC350_KZXwTENsLQfESSPUJZfwsEjrAvGtLRPCqqjk,31
|
|
20
|
-
windows_mcp/watchdog/event_handlers.py,sha256=E4CxuSMiGtffBPIR6RExKrsC4ngCei-4nT306_LxXFg,1880
|
|
21
|
-
windows_mcp/watchdog/service.py,sha256=tV1-gCXy17JubZyBn7s1ahgn-XVFTGW3dfiB5UhID3s,8670
|
|
22
|
-
windows_mcp-0.5.8.dist-info/METADATA,sha256=WJ-YTrDIDSjXlEjgcwXiBWLKErXOPjwFV_QoOMBIrAQ,14145
|
|
23
|
-
windows_mcp-0.5.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
|
|
24
|
-
windows_mcp-0.5.8.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
|
|
25
|
-
windows_mcp-0.5.8.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
|
|
26
|
-
windows_mcp-0.5.8.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|
|
File without changes
|