claude-kvm 2.0.6 → 2.0.8

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 (2) hide show
  1. package/README.md +12 -74
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,7 +1,5 @@
1
1
  # Claude KVM
2
2
 
3
- [![MCP Badge](https://lobehub.com/badge/mcp/aras-workspace-claude-kvm?style=flat)](https://lobehub.com/mcp/aras-workspace-claude-kvm)
4
-
5
3
  Claude KVM is an MCP tool that controls remote desktop environments over VNC. It consists of a thin JS proxy layer (MCP server) and a platform-native Swift VNC daemon running on your macOS system.
6
4
 
7
5
  [![Claude KVM Demo](https://github.com/ARAS-Workspace/claude-kvm/raw/press-kit/assets/test/linux/demo-run-22261661594.gif)](https://github.com/ARAS-Workspace/claude-kvm/blob/main/test/README.md)
@@ -14,71 +12,17 @@ Claude KVM is an MCP tool that controls remote desktop environments over VNC. It
14
12
  - [Mac Calculator Test](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22261139721)
15
13
  - [Mac Scientific Calculator Test](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22261184519)
16
14
  - [Mac Safari Browsing Test](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22261430282)
17
-
18
- > [!NOTE]
19
- > Tests are conducted transparently on GitHub Actions — each step is visible in the CI environment. At the end of every test, whether the integration passes or fails, you'll find screenshots of each step the agent took during the session, along with an `.mp4` video recording that captures the entire session. By reviewing these recordings and screenshots, you can observe how the agent progressed through each stage, how long the task took, and what decisions were made based on the system prompt. You can use these examples as a reference when crafting your own system prompts or instructions for the MCP server in your own environment.
20
-
21
- > [!WARNING]
22
- > Artifacts attached to these runs may have expired due to GitHub's artifact retention policy. Persistent copies are prepared via the [Persist Artifacts](https://github.com/ARAS-Workspace/claude-kvm/actions/workflows/persist-artifacts.yml) workflow and can always be accessed by run ID from the [`artifacts/`](https://github.com/ARAS-Workspace/claude-kvm/tree/press-kit/artifacts) directory on the press-kit branch.
15
+ - [Mac Drag & Drop Test](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22277460796)
16
+ - [Mac Chess Test](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22286270207)
17
+ - [Mac Chess Direct Test](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22286704229)
18
+ - [Mac Phantom-WG Install Test](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22315144741)
23
19
 
24
20
  ## Architecture
25
21
 
26
- ```mermaid
27
- graph TB
28
- subgraph MCP["MCP Client (Claude)"]
29
- AI["Claude"]
30
- end
31
-
32
- subgraph Proxy["claude-kvm · MCP Proxy (stdio)"]
33
- direction TB
34
- Server["MCP Server<br/><code>index.js</code>"]
35
- Tools["Tool Definitions<br/><code>tools/index.js</code>"]
36
- Server --> Tools
37
- end
38
-
39
- subgraph Daemon["claude-kvm-daemon · Native VNC Client (stdin/stdout)"]
40
- direction TB
41
- CMD["Command Handler<br/><i>PC Dispatch</i>"]
42
- Scale["Display Scaling<br/><i>Scaled ↔ Native</i>"]
43
-
44
- subgraph Screen["Screen"]
45
- Capture["Frame Capture<br/><i>PNG · Crop · Diff</i>"]
46
- OCR["OCR Detection<br/><i>Apple Vision</i>"]
47
- end
48
-
49
- subgraph InputGroup["Input"]
50
- Mouse["Mouse<br/><i>Click · Drag · Move · Scroll</i>"]
51
- KB["Keyboard<br/><i>Tap · Combo · Type · Paste</i>"]
52
- end
53
-
54
- VNC["VNC Bridge<br/><i>LibVNCClient 0.9.15</i>"]
55
-
56
- CMD --> Scale
57
- Scale --> Capture
58
- Scale --> Mouse
59
- Scale --> KB
60
- Capture -.->|"framebuffer"| VNC
61
- Mouse -->|"pointer events"| VNC
62
- KB -->|"key events"| VNC
63
- end
64
-
65
- subgraph Target["Target Machine"]
66
- VNC_Server["VNC Server<br/><i>:5900</i>"]
67
- Desktop["Desktop Environment"]
68
- VNC_Server --> Desktop
69
- end
70
-
71
- AI <-->|"stdio<br/>JSON-RPC"| Server
72
- Server <-->|"stdin/stdout<br/>PC (NDJSON)"| CMD
73
- VNC <-->|"RFB Protocol<br/>TCP :5900"| VNC_Server
74
-
75
- classDef proxy fill:#1a1a2e,stroke:#16213e,color:#e5e5e5
76
- classDef daemon fill:#0f3460,stroke:#533483,color:#e5e5e5
77
- classDef target fill:#1a1a2e,stroke:#e94560,color:#e5e5e5
78
-
79
- class Server,Tools proxy
80
- class CMD,Scale,VNC,Capture,Mouse,KB daemon
81
- class VNC_Server,Desktop target
22
+ ```bash
23
+ # Architecture
24
+ # Rendered as a Mermaid diagram on GitHub:
25
+ open "https://github.com/ARAS-Workspace/claude-kvm#architecture"
82
26
  ```
83
27
 
84
28
  ### Layers
@@ -139,13 +83,6 @@ brew tap ARAS-Workspace/tap
139
83
  brew install claude-kvm-daemon
140
84
  ```
141
85
 
142
- > [!NOTE]
143
- > `claude-kvm-daemon` is compiled and code-signed via CI (GitHub Actions). The build output is packaged in two formats: a `.tar.gz` archive for Homebrew distribution and a `.dmg` disk image for notarization. The DMG is submitted to Apple servers for notarization within the same workflow — the process can be tracked from CI logs. The notarized DMG is available as a CI Artifact; the archived `.tar.gz` is also published as a release on the repository. Homebrew installation tracks this release.
144
- >
145
- > - [Release](https://github.com/ARAS-Workspace/claude-kvm/releases/tag/daemon-v1.0.1) · [Source Code](https://github.com/ARAS-Workspace/claude-kvm/tree/daemon-tool)
146
- > - [LibVNC Build](https://github.com/ARAS-Workspace/claude-kvm/actions/runs/22122975416) · [LibVNC Branch](https://github.com/ARAS-Workspace/claude-kvm/tree/libvnc-build)
147
- > - [Homebrew Tap](https://github.com/ARAS-Workspace/homebrew-tap)
148
-
149
86
  ### MCP Configuration
150
87
 
151
88
  Create a `.mcp.json` file in your project directory:
@@ -169,9 +106,6 @@ Create a `.mcp.json` file in your project directory:
169
106
  }
170
107
  ```
171
108
 
172
- > [!NOTE]
173
- > The tool is end-to-end tested via CI — Claude executes tasks over VNC while an independent vision model observes and verifies the results. See the [Integration Test](https://github.com/ARAS-Workspace/claude-kvm/blob/main/test/README.md) for live workflow runs, system prompts, and demo recordings.
174
-
175
109
  ### Configuration
176
110
 
177
111
  #### MCP Proxy (ENV)
@@ -339,4 +273,8 @@ macOS is auto-detected via the ARD auth type 30 credential request. When detecte
339
273
 
340
274
  ---
341
275
 
276
+ [![MCP Badge](https://lobehub.com/badge/mcp/aras-workspace-claude-kvm?style=flat)](https://lobehub.com/mcp/aras-workspace-claude-kvm)
277
+
278
+ ---
279
+
342
280
  Copyright (c) 2026 Riza Emre ARAS — MIT License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-kvm",
3
- "version": "2.0.6",
3
+ "version": "2.0.8",
4
4
  "description": "MCP server — control remote desktops via VNC (MacOS)",
5
5
  "license": "MIT",
6
6
  "author": "Rıza Emre ARAS <r.emrearas@proton.me>",