@c5t8fbt-wy/winforms-mcp 1.0.6 → 1.0.7
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.
package/README.md
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# @c5t8fbt-wy/winforms-mcp
|
|
2
|
+
|
|
3
|
+
[](https://github.com/C5T8fBt-WY/winforms-mcp_fork/actions/workflows/ci.yml)
|
|
4
|
+
[](https://www.npmjs.com/package/@c5t8fbt-wy/winforms-mcp)
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
|
|
7
|
+
A Model Context Protocol (MCP) server for headless WinForms automation using FlaUI (UIA2/MSAA backend). Enables AI agents to discover, interact with, and automate Windows Forms applications — including modal dialogs — via Win32 fallback.
|
|
8
|
+
|
|
9
|
+
> **Windows only.** Requires .NET 8 runtime.
|
|
10
|
+
|
|
11
|
+
## Installation
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm install -g @c5t8fbt-wy/winforms-mcp
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Usage with Claude Desktop / VS Code
|
|
18
|
+
|
|
19
|
+
Add to your MCP config (e.g. `claude_desktop_config.json`):
|
|
20
|
+
|
|
21
|
+
```json
|
|
22
|
+
{
|
|
23
|
+
"mcpServers": {
|
|
24
|
+
"winforms-mcp": {
|
|
25
|
+
"command": "npx",
|
|
26
|
+
"args": ["@c5t8fbt-wy/winforms-mcp"]
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
Or run directly:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
npx @c5t8fbt-wy/winforms-mcp
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
## Available Tools (11)
|
|
39
|
+
|
|
40
|
+
| Tool | Description |
|
|
41
|
+
|------|-------------|
|
|
42
|
+
| `app` | Launch, attach, close, or inspect applications |
|
|
43
|
+
| `find` | Discover UI elements by name, automationId, type, or point |
|
|
44
|
+
| `click` | Click with mouse, touch, or pen input |
|
|
45
|
+
| `type` | Type text or send keyboard keys |
|
|
46
|
+
| `drag` | Drag with path support |
|
|
47
|
+
| `gesture` | Multi-touch: pinch, rotate, custom |
|
|
48
|
+
| `snapshot` | Capture UI tree as text — supports modal dialogs via Win32 fallback |
|
|
49
|
+
| `screenshot` | Capture window or element screenshot |
|
|
50
|
+
| `script` | Batch steps with variable interpolation |
|
|
51
|
+
| `launch_app_sandboxed` | Launch app in Windows Sandbox |
|
|
52
|
+
| `close_sandbox` / `list_sandbox_apps` | Manage sandbox |
|
|
53
|
+
|
|
54
|
+
## Key Features
|
|
55
|
+
|
|
56
|
+
- **Win32 fallback**: `snapshot`, `find(point:...)`, and `find(recursive:true)` automatically fall back to Win32 APIs when UIA is blocked by modal dialogs (e.g. `ShowDialog`)
|
|
57
|
+
- **Close modal dialogs**: `app(action:"close", handle:"0xHWND")` closes dialogs without PowerShell
|
|
58
|
+
- **All standard UIA operations**: click, type, drag, gesture, screenshot
|
|
59
|
+
|
|
60
|
+
## Source
|
|
61
|
+
|
|
62
|
+
Fork of [jhedin/winforms-mcp](https://github.com/jhedin/winforms-mcp) with Win32 modal dialog improvements.
|
|
63
|
+
Repository: [C5T8fBt-WY/winforms-mcp_fork](https://github.com/C5T8fBt-WY/winforms-mcp_fork)
|
|
Binary file
|
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,8 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@c5t8fbt-wy/winforms-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.7",
|
|
4
4
|
"description": "WinForms automation MCP server with headless UI automation capabilities",
|
|
5
5
|
"main": "index.js",
|
|
6
|
+
"files": [
|
|
7
|
+
"dist",
|
|
8
|
+
"bin",
|
|
9
|
+
"index.js",
|
|
10
|
+
"install.js",
|
|
11
|
+
"README.md"
|
|
12
|
+
],
|
|
6
13
|
"bin": {
|
|
7
14
|
"winforms-mcp": "./bin/winforms-mcp.js"
|
|
8
15
|
},
|