@harusame64/desktop-touch-mcp 0.11.6 → 0.11.11

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.
Files changed (3) hide show
  1. package/README.ja.md +59 -44
  2. package/README.md +73 -59
  3. package/package.json +1 -1
package/README.ja.md CHANGED
@@ -40,44 +40,59 @@ Claude がデスクトップを直接見て、直接操作する。
40
40
 
41
41
  ---
42
42
 
43
- ## インストール
44
-
45
- ```bash
46
- npx -y @harusame64/desktop-touch-mcp
47
- ```
48
-
49
- npm ランチャーは初回起動時に GitHub Releases から最新の `desktop-touch-mcp-windows.zip` をダウンロードし、`%USERPROFILE%\.desktop-touch-mcp` に展開してキャッシュします。以後は新しい GitHub Release が出ていない限り、キャッシュ済みの実体を再利用します。
50
-
51
- ### Claude CLI への登録
52
-
53
- `~/.claude.json` の `mcpServers` に追加：
54
-
55
- ```json
56
- {
57
- "mcpServers": {
58
- "desktop-touch": {
59
- "type": "stdio",
60
- "command": "npx",
61
- "args": ["-y", "@harusame64/desktop-touch-mcp"]
62
- }
63
- }
64
- }
65
- ```
66
-
67
- ### 開発用インストール
68
-
69
- ```bash
70
- git clone https://github.com/Harusame64/desktop-touch-mcp.git
71
- cd desktop-touch-mcp
72
- npm install
73
- ```
74
-
75
- `npm install` 実行時に `prepare` スクリプトが TypeScript を `dist/` にコンパイルします。別途 `npm run build` は不要です。
76
-
77
- ローカルチェックアウトを使う場合は、ビルド済みのサーバーを直接登録します。
78
-
79
- ```json
80
- {
43
+ ## インストール
44
+
45
+ ```bash
46
+ npx -y @harusame64/desktop-touch-mcp
47
+ ```
48
+
49
+ npm ランチャーは初回起動時に GitHub Releases から最新の `desktop-touch-mcp-windows.zip` をダウンロードし、`%USERPROFILE%\.desktop-touch-mcp` に展開してキャッシュします。以後は新しい GitHub Release が出ていない限り、キャッシュ済みの実体を再利用します。
50
+
51
+ ### Claude CLI への登録
52
+
53
+ `~/.claude.json` の `mcpServers` に追加：
54
+
55
+ ```json
56
+ {
57
+ "mcpServers": {
58
+ "desktop-touch": {
59
+ "type": "stdio",
60
+ "command": "npx",
61
+ "args": ["-y", "@harusame64/desktop-touch-mcp"]
62
+ }
63
+ }
64
+ }
65
+ ```
66
+
67
+ ### HTTP モードでの起動（GPT Desktop / VS Code / Cursor など）
68
+
69
+ HTTP 接続が必要なクライアントには `--http` フラグを使います。
70
+
71
+ ```bash
72
+ npx -y @harusame64/desktop-touch-mcp --http
73
+ # ポートを変更する場合:
74
+ npx -y @harusame64/desktop-touch-mcp --http --port 8080
75
+ ```
76
+
77
+ デフォルトポートは `23847`。`http://127.0.0.1:23847/mcp` をクライアントの MCP サーバー URL に登録してください（ローカルのみ、外部公開なし）。
78
+ ヘルスチェック: `http://127.0.0.1:<port>/health`
79
+
80
+ HTTP モード起動時はタスクトレイにバルーン通知が表示され、右クリックメニューから URL コピー・ブラウザで確認・終了が行えます。
81
+
82
+ ### 開発用インストール
83
+
84
+ ```bash
85
+ git clone https://github.com/Harusame64/desktop-touch-mcp.git
86
+ cd desktop-touch-mcp
87
+ npm install
88
+ ```
89
+
90
+ `npm install` 実行時に `prepare` スクリプトが TypeScript を `dist/` にコンパイルします。別途 `npm run build` は不要です。
91
+
92
+ ローカルチェックアウトを使う場合は、ビルド済みのサーバーを直接登録します。
93
+
94
+ ```json
95
+ {
81
96
  "mcpServers": {
82
97
  "desktop-touch": {
83
98
  "type": "stdio",
@@ -324,12 +339,12 @@ UIA ブリッジの `-like` パターンには `escapeLike()` でワイルドカ
324
339
  ```json
325
340
  {
326
341
  "mcpServers": {
327
- "desktop-touch": {
328
- "type": "stdio",
329
- "command": "npx",
330
- "args": ["-y", "@harusame64/desktop-touch-mcp"],
331
- "env": {
332
- "DESKTOP_TOUCH_MOUSE_SPEED": "3000"
342
+ "desktop-touch": {
343
+ "type": "stdio",
344
+ "command": "npx",
345
+ "args": ["-y", "@harusame64/desktop-touch-mcp"],
346
+ "env": {
347
+ "DESKTOP_TOUCH_MOUSE_SPEED": "3000"
333
348
  }
334
349
  }
335
350
  }
package/README.md CHANGED
@@ -41,59 +41,73 @@ An MCP server that gives Claude eyes and hands on Windows — 56 tools covering
41
41
 
42
42
  ---
43
43
 
44
- ## Installation
45
-
46
- ```bash
47
- npx -y @harusame64/desktop-touch-mcp
48
- ```
49
-
50
- The npm launcher downloads the latest `desktop-touch-mcp-windows.zip` from GitHub Releases on first run and caches it under `%USERPROFILE%\.desktop-touch-mcp`. Later runs reuse the cached release unless a newer GitHub Release is available.
51
-
52
- ### Register with Claude CLI
53
-
54
- Add to `~/.claude.json` under `mcpServers`:
55
-
56
- ```json
57
- {
58
- "mcpServers": {
59
- "desktop-touch": {
60
- "type": "stdio",
61
- "command": "npx",
62
- "args": ["-y", "@harusame64/desktop-touch-mcp"]
63
- }
64
- }
65
- }
66
- ```
67
-
68
- **No system prompt needed.** The command reference is automatically injected into Claude via the MCP `initialize` response's `instructions` field.
69
-
70
- ### Development install
71
-
72
- ```bash
73
- git clone https://github.com/Harusame64/desktop-touch-mcp.git
74
- cd desktop-touch-mcp
75
- npm install
76
- ```
77
-
78
- `npm install` runs the `prepare` script, which compiles TypeScript to `dist/`. No separate build step is required.
79
-
80
- For a local checkout, register the built server directly:
81
-
82
- ```json
83
- {
84
- "mcpServers": {
44
+ ## Installation
45
+
46
+ ```bash
47
+ npx -y @harusame64/desktop-touch-mcp
48
+ ```
49
+
50
+ The npm launcher downloads the latest `desktop-touch-mcp-windows.zip` from GitHub Releases on first run and caches it under `%USERPROFILE%\.desktop-touch-mcp`. Later runs reuse the cached release unless a newer GitHub Release is available.
51
+
52
+ ### Register with Claude CLI
53
+
54
+ Add to `~/.claude.json` under `mcpServers`:
55
+
56
+ ```json
57
+ {
58
+ "mcpServers": {
59
+ "desktop-touch": {
60
+ "type": "stdio",
61
+ "command": "npx",
62
+ "args": ["-y", "@harusame64/desktop-touch-mcp"]
63
+ }
64
+ }
65
+ }
66
+ ```
67
+
68
+ **No system prompt needed.** The command reference is automatically injected into Claude via the MCP `initialize` response's `instructions` field.
69
+
70
+ ### Register with other clients (HTTP mode)
71
+
72
+ Clients that require an HTTP endpoint (GPT Desktop, VS Code Copilot, Cursor, etc.) can use the built-in Streamable HTTP transport:
73
+
74
+ ```bash
75
+ npx -y @harusame64/desktop-touch-mcp --http
76
+ # or with a custom port:
77
+ npx -y @harusame64/desktop-touch-mcp --http --port 8080
78
+ ```
79
+
80
+ The server starts at `http://127.0.0.1:23847/mcp` (localhost only). Register the URL in your MCP client settings. A health check is available at `http://127.0.0.1:<port>/health`.
81
+
82
+ In HTTP mode the system tray icon shows the active URL and provides quick-copy and open-in-browser shortcuts.
83
+
84
+ ### Development install
85
+
86
+ ```bash
87
+ git clone https://github.com/Harusame64/desktop-touch-mcp.git
88
+ cd desktop-touch-mcp
89
+ npm install
90
+ ```
91
+
92
+ `npm install` runs the `prepare` script, which compiles TypeScript to `dist/`. No separate build step is required.
93
+
94
+ For a local checkout, register the built server directly:
95
+
96
+ ```json
97
+ {
98
+ "mcpServers": {
85
99
  "desktop-touch": {
86
100
  "type": "stdio",
87
101
  "command": "node",
88
102
  "args": ["D:/path/to/desktop-touch-mcp/dist/index.js"]
89
103
  }
90
104
  }
91
- }
92
- ```
93
-
94
- > **Note:** Replace `D:/path/to/desktop-touch-mcp` with the actual path where you cloned this repository.
95
-
96
- ---
105
+ }
106
+ ```
107
+
108
+ > **Note:** Replace `D:/path/to/desktop-touch-mcp` with the actual path where you cloned this repository.
109
+
110
+ ---
97
111
 
98
112
  ## Tools (56 total)
99
113
 
@@ -229,12 +243,12 @@ Keep Claude CLI visible while operating other apps full-screen. Set env vars in
229
243
  ```json
230
244
  {
231
245
  "mcpServers": {
232
- "desktop-touch": {
233
- "type": "stdio",
234
- "command": "npx",
235
- "args": ["-y", "@harusame64/desktop-touch-mcp"],
236
- "env": {
237
- "DESKTOP_TOUCH_DOCK_TITLE": "@parent",
246
+ "desktop-touch": {
247
+ "type": "stdio",
248
+ "command": "npx",
249
+ "args": ["-y", "@harusame64/desktop-touch-mcp"],
250
+ "env": {
251
+ "DESKTOP_TOUCH_DOCK_TITLE": "@parent",
238
252
  "DESKTOP_TOUCH_DOCK_CORNER": "bottom-right",
239
253
  "DESKTOP_TOUCH_DOCK_WIDTH": "480",
240
254
  "DESKTOP_TOUCH_DOCK_HEIGHT": "360",
@@ -424,12 +438,12 @@ All mouse tools (`mouse_move`, `mouse_click`, `mouse_drag`, `scroll`) accept an
424
438
  ```json
425
439
  {
426
440
  "mcpServers": {
427
- "desktop-touch": {
428
- "type": "stdio",
429
- "command": "npx",
430
- "args": ["-y", "@harusame64/desktop-touch-mcp"],
431
- "env": {
432
- "DESKTOP_TOUCH_MOUSE_SPEED": "3000"
441
+ "desktop-touch": {
442
+ "type": "stdio",
443
+ "command": "npx",
444
+ "args": ["-y", "@harusame64/desktop-touch-mcp"],
445
+ "env": {
446
+ "DESKTOP_TOUCH_MOUSE_SPEED": "3000"
433
447
  }
434
448
  }
435
449
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@harusame64/desktop-touch-mcp",
3
- "version": "0.11.6",
3
+ "version": "0.11.11",
4
4
  "description": "LLM-native Windows computer-use MCP server with 56 tools for screenshots, UIA, mouse/keyboard, Chrome CDP, terminal, SmartScroll, and perception guards",
5
5
  "engines": {
6
6
  "node": ">=20.0.0"