vamp-mcp 0.2.0 → 0.2.3

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 (133) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +142 -107
  3. package/THIRD_PARTY_NOTICES.md +32 -27
  4. package/bin/vamp-mcp.mjs +37 -37
  5. package/notices/mcp-virtualbox-LICENSE +21 -21
  6. package/notices/mcp-virtualbox-PROVENANCE.json +37 -37
  7. package/package.json +51 -17
  8. package/runtime/backends/common/Test-Environment.ps1 +7 -6
  9. package/runtime/backends/common/guest-install.json +58 -0
  10. package/runtime/backends/common/guest_install.py +57 -0
  11. package/runtime/backends/common/host-support.cjs +16 -0
  12. package/runtime/backends/common/packer.cjs +16 -0
  13. package/runtime/backends/hyperv/scripts/Manage-Desktop.ps1 +40 -67
  14. package/runtime/backends/hyperv/scripts/Send-InstallerBoot.ps1 +25 -0
  15. package/runtime/backends/kvm/debian-preseed.cfg +35 -35
  16. package/runtime/backends/library/registry.py +77 -77
  17. package/runtime/backends/library/replay.py +154 -154
  18. package/runtime/backends/packer/answer_media.py +16 -0
  19. package/runtime/backends/packer/deploy-hyperv.ps1 +10 -0
  20. package/runtime/backends/packer/drivers.py +49 -0
  21. package/runtime/backends/packer/hyperv-network.ps1 +10 -0
  22. package/runtime/backends/packer/images.py +75 -0
  23. package/runtime/backends/packer/osinfo.py +113 -0
  24. package/runtime/backends/packer/policy.json +15 -0
  25. package/runtime/backends/packer/runner.py +224 -0
  26. package/runtime/backends/packer/templates.py +118 -0
  27. package/runtime/backends/packer/toolchain.py +80 -0
  28. package/runtime/backends/remote_ssh/server.mjs +310 -93
  29. package/runtime/backends/virtualbox/desktop.cjs +37 -0
  30. package/runtime/backends/virtualbox/display.py +101 -101
  31. package/runtime/backends/virtualbox/history.py +139 -139
  32. package/runtime/backends/virtualbox/mouse_click.py +15 -15
  33. package/runtime/backends/virtualbox/mouse_move.py +18 -18
  34. package/runtime/backends/virtualbox/profiles.json +46 -46
  35. package/runtime/backends/virtualbox/provision.py +238 -197
  36. package/runtime/backends/virtualbox/recording_listener.py +29 -29
  37. package/runtime/backends/virtualbox/recordings.py +39 -39
  38. package/runtime/backends/virtualbox/requirements.txt +7 -7
  39. package/runtime/backends/virtualbox/rpas/debian_first_boot/manifest.json +1 -1
  40. package/runtime/backends/virtualbox/rpas/debian_first_boot/run.robot +13 -13
  41. package/runtime/backends/virtualbox/rpas/debian_first_boot/workflow.py +75 -75
  42. package/runtime/backends/virtualbox/rpas/observe/manifest.json +7 -7
  43. package/runtime/backends/virtualbox/rpas/observe/run.robot +13 -13
  44. package/runtime/backends/virtualbox/rpas/observe/workflow.py +14 -14
  45. package/runtime/backends/virtualbox/server.mjs +288 -237
  46. package/runtime/backends/virtualbox/setup_windows_sdk.py +58 -58
  47. package/runtime/backends/virtualbox/shares.py +68 -68
  48. package/runtime/backends/virtualbox/snapshots.py +53 -53
  49. package/runtime/backends/virtualbox/transfers.py +89 -89
  50. package/runtime/backends/virtualbox/vnc.py +61 -61
  51. package/runtime/guest_keys.py +13 -13
  52. package/runtime/guest_setup/http/debian-preseed.cfg +39 -0
  53. package/runtime/guest_setup/http/postdeb.sh +50 -3
  54. package/runtime/guest_setup/http/postwin.ps1 +53 -28
  55. package/runtime/guest_setup/http/setup-all.ps1 +25 -25
  56. package/runtime/guest_setup/http/setup-win.cmd +7 -7
  57. package/runtime/guest_setup/http/setup.ps1 +44 -29
  58. package/runtime/guest_setup/kvm/setup-windows.ps1 +52 -52
  59. package/runtime/guest_setup/recorder/README.txt +12 -12
  60. package/runtime/guest_setup/recorder/RECORDER-LICENSE +674 -674
  61. package/runtime/guest_setup/recorder/RECORDING-GUIDE.txt +31 -31
  62. package/runtime/guest_setup/recorder/apply-display.py +41 -41
  63. package/runtime/guest_setup/recorder/configure-debian-mirrors.py +62 -62
  64. package/runtime/guest_setup/recorder/configure-gdm.py +23 -0
  65. package/runtime/guest_setup/recorder/configure-session.ps1 +14 -0
  66. package/runtime/guest_setup/recorder/gnome-display.py +60 -60
  67. package/runtime/guest_setup/recorder/install-display-startup.py +66 -39
  68. package/runtime/guest_setup/recorder/install-hypervisor-drivers.ps1 +34 -0
  69. package/runtime/guest_setup/recorder/install-resolution-shortcut.ps1 +36 -0
  70. package/runtime/guest_setup/recorder/postwin.cmd +10 -10
  71. package/runtime/guest_setup/recorder/prepare-recording.py +30 -30
  72. package/runtime/guest_setup/recorder/requirements-recorder.txt +2 -2
  73. package/runtime/guest_setup/recorder/session-policy.py +22 -0
  74. package/runtime/guest_setup/recorder/setup-user.py +53 -53
  75. package/runtime/guest_setup/recorder/setup-win.cmd +4 -60
  76. package/runtime/guest_setup/recorder/setup.ps1 +108 -81
  77. package/runtime/guest_setup/recorder/setup.sh +1 -0
  78. package/runtime/guest_setup/recorder/vamp-recorder.py +148 -148
  79. package/runtime/guest_setup/recorder/verify-recorder.py +4 -4
  80. package/runtime/guest_setup/recorder/windows-display.py +76 -76
  81. package/runtime/guest_setup/requirements.txt +2 -2
  82. package/runtime/guest_setup/setup-all.ps1 +35 -35
  83. package/runtime/guest_setup/vault/Install-VCRuntime.ps1 +26 -26
  84. package/runtime/guest_setup/vault/setup-guest-vault.ps1 +148 -148
  85. package/runtime/recording_converter.py +230 -230
  86. package/runtime/requirements-mcp.txt +11 -11
  87. package/runtime/rpas/README.md +161 -161
  88. package/runtime/rpas/captcha_handoff/manifest.json +27 -27
  89. package/runtime/rpas/captcha_handoff/run.robot +16 -16
  90. package/runtime/rpas/captcha_handoff/workflow.py +11 -11
  91. package/runtime/rpas/common.resource +26 -26
  92. package/runtime/rpas/debian_update/manifest.json +27 -27
  93. package/runtime/rpas/debian_update/run.robot +17 -17
  94. package/runtime/rpas/debian_update/workflow.py +13 -13
  95. package/runtime/rpas/desktop_control/manifest.json +26 -26
  96. package/runtime/rpas/desktop_control/run.robot +27 -27
  97. package/runtime/rpas/desktop_control/workflow.py +51 -51
  98. package/runtime/rpas/firefox_launch/manifest.json +27 -27
  99. package/runtime/rpas/firefox_launch/run.robot +15 -15
  100. package/runtime/rpas/firefox_launch/workflow.py +25 -25
  101. package/runtime/rpas/firefox_naver/manifest.json +27 -27
  102. package/runtime/rpas/firefox_naver/run.robot +21 -21
  103. package/runtime/rpas/firefox_naver/workflow.py +28 -28
  104. package/runtime/rpas/kvm_validation/README.md +11 -11
  105. package/runtime/rpas/kvm_validation/manifest.json +28 -28
  106. package/runtime/rpas/kvm_validation/run.robot +30 -30
  107. package/runtime/rpas/kvm_validation/workflow.py +91 -91
  108. package/runtime/rpas/manifest.schema.json +105 -105
  109. package/runtime/rpas/naver_login/login.robot +25 -25
  110. package/runtime/rpas/naver_login/manifest.json +33 -33
  111. package/runtime/rpas/naver_login/run.robot +20 -20
  112. package/runtime/rpas/naver_login/workflow.py +32 -32
  113. package/runtime/rpas/windows_naver_recorded/README.md +24 -24
  114. package/runtime/rpas/windows_naver_recorded/conversion.json +25 -25
  115. package/runtime/rpas/windows_naver_recorded/manifest.json +28 -28
  116. package/runtime/rpas/windows_naver_recorded/run.robot +37 -37
  117. package/runtime/rpas/windows_naver_recorded/workflow.py +32 -32
  118. package/runtime/scripts/build_recorder_media.py +39 -39
  119. package/runtime/scripts/macos/setup-host.sh +0 -0
  120. package/runtime/scripts/script_server.py +571 -517
  121. package/runtime/skills/vamp-rpa-ui-checks/SKILL.md +26 -0
  122. package/runtime/skills/vamp-rpa-ui-checks/agents/openai.yaml +4 -0
  123. package/runtime/skills/vamp-rpa-ui-checks/references/display.md +12 -0
  124. package/runtime/skills/vamp-rpa-ui-checks/references/user-guide.md +49 -0
  125. package/runtime/skills/vamp-ui-cleanup/SKILL.md +15 -0
  126. package/runtime/skills/vamp-ui-cleanup/agents/openai.yaml +4 -0
  127. package/runtime/skills/vamp-ui-validation/SKILL.md +27 -0
  128. package/runtime/skills/vamp-ui-validation/agents/openai.yaml +4 -0
  129. package/runtime/third_party/mcp-virtualbox/scripts/mouse_click.py +65 -65
  130. package/runtime/third_party/pyautogui-recorder/LICENSE +674 -674
  131. package/runtime/third_party/pyautogui-recorder/PROVENANCE.json +16 -16
  132. package/runtime/third_party/pyautogui-recorder/PyAutoGuiRecorder.py +169 -169
  133. package/runtime/third_party/pyautogui-recorder/README.md +53 -53
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 VM RPA contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 VM RPA contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,107 +1,142 @@
1
- # VAMP MCP
2
-
3
- Independent stdio MCP servers for VM-isolated GUI automation. Run with an MCP client such as VS Code or Codex; the VS Code extension is optional for these servers.
4
-
5
- ## Requirements and scope
6
-
7
- - Node.js 22+.
8
- - Local VirtualBox tools need VirtualBox 7.x. Python helper tools need Python 3.11+; set `RPA_HOST_PYTHON` to your Python executable. Install Robot Framework, pycdlib, asyncvnc or the matching VirtualBox Python SDK when the chosen operation requires them.
9
- - The `remote` server runs on the host owning KVM/libvirt or VirtualBox. To operate a different machine, start it there over SSH. Linux KVM requires access to `virsh` and the selected libvirt URI. VM creation also needs `virt-install` and `qemu-img`. Debian automatic installation boots the stock ISO and injects a preseed into the initrd; `xorriso` is not used. Guest setup is served over HTTP from a host Python 3 server on port 8421.
10
- - Provide your own VMs, guest operating systems, licenses and Guest Additions when needed. Package installation does not create VMs or install system dependencies.
11
- - VAMP Vault MCP is a separate npm package, `vamp-mcp-vault`. The live viewer and graphical manager require the VS Code extensions; npm does not install them. Hyper-V is not included in this npm release.
12
- - Full SPICE/OCR/YOLO workflows still require the source repository and their documented environments.
13
-
14
- ## Install and run
15
-
16
- ```sh
17
- npm install -g vamp-mcp
18
- vamp-mcp --help
19
- ```
20
-
21
- Or run without a global install:
22
-
23
- ```sh
24
- npx -y vamp-mcp@0.2.0 virtualbox
25
- npx -y vamp-mcp@0.2.0 kvm
26
- npx -y vamp-mcp@0.2.0 library
27
- npx -y vamp-mcp@0.2.0 remote --backend kvm
28
- ```
29
-
30
- Servers communicate over standard input/output and wait for an MCP client. Use separate MCP registrations for each server. Installation alone does not register them with every client.
31
-
32
- ## VS Code MCP configuration
33
-
34
- Add a server to `.vscode/mcp.json` (on Windows use `npx.cmd` if your client requires it):
35
-
36
- ```json
37
- {
38
- "servers": {
39
- "vamp": {
40
- "type": "stdio",
41
- "command": "npx",
42
- "args": ["-y", "vamp-mcp@0.2.0", "virtualbox"],
43
- "env": {"RPA_HOST_PYTHON": "/absolute/path/to/python"}
44
- }
45
- }
46
- }
47
- ```
48
-
49
- Replace the Python path with an existing executable on your host.
50
-
51
- ## Codex MCP configuration
52
-
53
- In `~/.codex/config.toml`:
54
-
55
- ```toml
56
- [mcp_servers.vamp]
57
- command = "npx"
58
- args = ["-y", "vamp-mcp@0.2.0", "virtualbox"]
59
-
60
- [mcp_servers.vamp.env]
61
- RPA_HOST_PYTHON = "/absolute/path/to/python"
62
- ```
63
-
64
- For KVM, change the final argument from `virtualbox` to `kvm`. This uses the existing host controller: inventory, VM creation, start/stop, screenshots, keyboard/mouse and saved RPA replay. It does not provide the full source-repository SPICE/OCR environment or a live viewer.
65
-
66
- For the RPA library, register `library` instead and set `VAMP_RPA_REGISTRY` to your saved VAMP catalog directory. Its default is `~/.vamp/rpa-catalog`; an existing VS Code catalog must be selected explicitly. The library searches and replays reviewed definitions; it does not provide the extension's authoring UI. Replay needs its Python dependencies and a reviewed, compatible RPA. Actions completing does not prove application success; verify the expected outcome.
67
-
68
- ## Remote host example
69
-
70
- Install this package on the VM host, then configure an MCP client to run:
71
-
72
- ```sh
73
- ssh -T user@vm-host vamp-mcp remote --backend kvm
74
- ```
75
-
76
- The remote shell must find `vamp-mcp` and Node on its PATH. Specify their installed absolute paths if necessary. Prefer SSH keys and your existing SSH configuration; do not put passwords in MCP configuration.
77
-
78
- ## Build and verify from source
79
-
80
- From the repository root, prepare the existing runtime build dependencies:
81
-
82
- ```sh
83
- npm ci --prefix third_party/mcp-virtualbox --ignore-scripts
84
- npm run build --prefix third_party/mcp-virtualbox
85
- npm ci --prefix vscode-extension --ignore-scripts
86
- npm run build --prefix npm-package
87
- npm pack ./npm-package --pack-destination /tmp
88
- VAMP_TEST_TARBALL=/tmp/vamp-mcp-0.2.0.tgz npm test --prefix npm-package
89
- ```
90
-
91
- The build reuses the VSIX runtime bundling and dependency license notices. The published package has no install scripts and no npm runtime dependencies; JavaScript dependencies are bundled. See the repository for backend-specific setup and validation limits.
92
-
93
- [Source and documentation](https://github.com/wayfarer6/vamp-mcp)
94
-
95
- ## VM creation and installation
96
-
97
- For KVM, call `remote_vm_create` with `name`, an absolute host `iso_path`, `guest_os:"debian"`, and `confirmed:true` after user authorization. Debian amd64 installer ISOs default to unattended installation; use `installation_mode:"manual"` to opt out. Ubuntu/Windows installation is manual; Windows additionally requires `windows_confirmed:true` and your own valid license.
98
-
99
- For VirtualBox, use `vm_create`. Compatible ISOs use VirtualBox unattended installation; when VirtualBox reports the ISO as unsupported, the stock installer runs and you complete it manually. VAMP never rewrites the ISO and does not use `xorriso`. The post-install hook downloads the guest setup from the host HTTP server on port 8421 (`vm_script_server_start`, `vm_script_server_stop`, `vm_script_server_status`), and `vm_guest_bootstrap` serves and types the wget/`irm` command.
100
-
101
- Automatic Debian installation uses the **public sandbox account `vboxuser` / `password123!`**. Change it before using the VM for private work. The source ISO and existing VMs are never overwritten; the stock ISO is attached or read as-is. Guest setup scripts are staged into a per-user state folder and served read-only on port 8421 (no directory listing, 30-minute default TTL). Unsupported installer layouts fail with an error; they do not silently count as successful installation.
102
-
103
- `startup_verified:true` confirms Running state only. Verify OS installation and the guest desktop separately. Recorder/Vault guest setup is not automatically completed by this Debian path. The full repository's richer lab installers remain separate workflows.
104
-
105
- On Linux, stop active VirtualBox VMs before starting KVM and vice versa. Concurrent use can crash VirtualBox with `VERR_SVM_IN_USE`; creation/start paths check for the other hypervisor.
106
-
107
- 한국어: `vamp-mcp` 하나에서 VirtualBox와 KVM을 선택합니다. KVM의 `remote_vm_create`는 명시적 확인 후 VM을 생성·기동하며, Debian amd64 설치 ISO는 순정 ISO 부팅과 preseed 커널 주입으로 자동 설치합니다(xorriso 불필요). Python·virt-install·qemu-img를 호스트에 준비하세요. 게스트 설정 스크립트는 파이썬 HTTP 서버가 8421 포트로 제공하고 게스트가 wget/curl로 내려받습니다. 공개 테스트 계정은 `vboxuser` / `password123!`입니다. VM 기동 성공과 OS·게스트 도구 설치 완료는 별도로 검증해야 합니다. Linux에서는 KVM과 VirtualBox VM을 동시에 실행하지 마세요.
1
+ # VAMP MCP
2
+
3
+ Independent stdio MCP servers for VM-isolated GUI automation. Run with an MCP client such as VS Code or Codex; the VS Code extension is optional for these servers.
4
+
5
+ ## Requirements and scope
6
+
7
+ - Node.js 22+.
8
+ - Local VirtualBox tools need VirtualBox 7.x. Python helper tools need Python 3.11+; set `RPA_HOST_PYTHON` to your Python executable. Install Robot Framework, pycdlib, asyncvnc or the matching VirtualBox Python SDK when the chosen operation requires them.
9
+ - The `remote` server runs on the host owning KVM/libvirt or VirtualBox. To operate a different machine, start it there over SSH. Linux KVM requires access to `virsh` and the selected libvirt URI. VM creation also needs `virt-install` and `qemu-img`. Debian automatic installation boots the stock ISO and injects a preseed into the initrd; `xorriso` is not used. Guest setup is served over HTTP from a host Python 3 server on port 8421.
10
+ - Provide your own VMs, guest operating systems, licenses and Guest Additions when needed. Package installation does not create VMs or install system dependencies.
11
+ - VAMP Vault MCP is a separate npm package, `vamp-mcp-vault`. The live viewer and graphical manager require the VS Code extensions; npm does not install them. Hyper-V is not included in this npm release.
12
+ - Full SPICE/OCR/YOLO workflows still require the source repository and their documented environments.
13
+
14
+ ## Install and run
15
+
16
+ ```sh
17
+ npm install -g vamp-mcp
18
+ vamp-mcp --help
19
+ ```
20
+
21
+ Or run without a global install:
22
+
23
+ ```sh
24
+ npx -y vamp-mcp@0.2.0 virtualbox
25
+ npx -y vamp-mcp@0.2.0 kvm
26
+ npx -y vamp-mcp@0.2.0 library
27
+ npx -y vamp-mcp@0.2.0 remote --backend kvm
28
+ ```
29
+
30
+ Servers communicate over standard input/output and wait for an MCP client. Use separate MCP registrations for each server. Installation alone does not register them with every client.
31
+
32
+ ## VS Code MCP configuration
33
+
34
+ Add a server to `.vscode/mcp.json` (on Windows use `npx.cmd` if your client requires it):
35
+
36
+ ```json
37
+ {
38
+ "servers": {
39
+ "vamp": {
40
+ "type": "stdio",
41
+ "command": "npx",
42
+ "args": ["-y", "vamp-mcp@0.2.0", "virtualbox"],
43
+ "env": {"RPA_HOST_PYTHON": "/absolute/path/to/python"}
44
+ }
45
+ }
46
+ }
47
+ ```
48
+
49
+ Replace the Python path with an existing executable on your host.
50
+
51
+ ## Codex MCP configuration
52
+
53
+ In `~/.codex/config.toml`:
54
+
55
+ ```toml
56
+ [mcp_servers.vamp]
57
+ command = "npx"
58
+ args = ["-y", "vamp-mcp@0.2.0", "virtualbox"]
59
+
60
+ [mcp_servers.vamp.env]
61
+ RPA_HOST_PYTHON = "/absolute/path/to/python"
62
+ ```
63
+
64
+ For KVM, change the final argument from `virtualbox` to `kvm`. This uses the existing host controller: inventory, VM creation, start/stop, screenshots, keyboard/mouse and saved RPA replay. It does not provide the full source-repository SPICE/OCR environment or a live viewer.
65
+
66
+ For the RPA library, register `library` instead and set `VAMP_RPA_REGISTRY` to your saved VAMP catalog directory. Its default is `~/.vamp/rpa-catalog`; an existing VS Code catalog must be selected explicitly. The library searches and replays reviewed definitions; it does not provide the extension's authoring UI. Replay needs its Python dependencies and a reviewed, compatible RPA. Actions completing does not prove application success; verify the expected outcome.
67
+
68
+ ## Remote host example
69
+
70
+ Install this package on the VM host, then configure an MCP client to run:
71
+
72
+ ```sh
73
+ ssh -T user@vm-host vamp-mcp remote --backend kvm
74
+ ```
75
+
76
+ The remote shell must find `vamp-mcp` and Node on its PATH. Specify their installed absolute paths if necessary. Prefer SSH keys and your existing SSH configuration; do not put passwords in MCP configuration.
77
+
78
+ ## Build and verify from source
79
+
80
+ From the repository root, prepare the existing runtime build dependencies:
81
+
82
+ ```sh
83
+ npm ci --prefix third_party/mcp-virtualbox --ignore-scripts
84
+ npm run build --prefix third_party/mcp-virtualbox
85
+ npm ci --prefix vscode-extension --ignore-scripts
86
+ npm run build --prefix npm-package
87
+ npm pack ./npm-package --pack-destination /tmp
88
+ VAMP_TEST_TARBALL=/tmp/vamp-mcp-0.2.0.tgz npm test --prefix npm-package
89
+ ```
90
+
91
+ The build reuses the VSIX runtime bundling and dependency license notices. The published package has no install scripts and no npm runtime dependencies; JavaScript dependencies are bundled. See the repository for backend-specific setup and validation limits.
92
+
93
+ [Source and documentation](https://github.com/wayfarer6/vamp-mcp)
94
+
95
+ ## VM creation and installation
96
+
97
+ For KVM, call `remote_vm_create` with `name`, an absolute host `iso_path`, `guest_os:"debian"`, and `confirmed:true` after user authorization. Debian amd64 installer ISOs default to unattended installation; use `installation_mode:"manual"` to opt out. Ubuntu/Windows installation is manual; Windows additionally requires `windows_confirmed:true` and your own valid license.
98
+
99
+ For VirtualBox, use `vm_create`. Compatible ISOs use VirtualBox unattended installation; when VirtualBox reports the ISO as unsupported, the stock installer runs and you complete it manually. VAMP never rewrites the ISO and does not use `xorriso`. The post-install hook downloads the guest setup from the host HTTP server on port 8421 (`vm_script_server_start`, `vm_script_server_stop`, `vm_script_server_status`), and `vm_guest_bootstrap` serves and types the wget/`irm` command.
100
+
101
+ Automatic Debian installation uses the **public sandbox account `vboxuser` / `password123!`**. Change it before using the VM for private work. The source ISO and existing VMs are never overwritten; the stock ISO is attached or read as-is. Guest setup scripts are staged into a per-user state folder and served read-only on port 8421 (no directory listing, 30-minute default TTL). Unsupported installer layouts fail with an error; they do not silently count as successful installation.
102
+
103
+ `startup_verified:true` confirms Running state only. Verify OS installation and the guest desktop separately. Recorder/Vault guest setup is not automatically completed by this Debian path. The full repository's richer lab installers remain separate workflows.
104
+
105
+ On Linux, stop active VirtualBox VMs before starting KVM and vice versa. Concurrent use can crash VirtualBox with `VERR_SVM_IN_USE`; creation/start paths check for the other hypervisor.
106
+
107
+
108
+ ## VM installation with HashiCorp Packer
109
+
110
+ VAMP uses **HashiCorp Packer** to automate new VM installation and post-install setup. Prepare Environment downloads the pinned Packer CLI for Windows x64, Linux x64/ARM64 or macOS Intel/Apple Silicon, verifies its SHA-256, and installs the selected official plugin with `packer init`: VirtualBox, Hyper-V or QEMU (KVM). The hypervisor itself remains a host prerequisite. Windows ARM64 has no pinned native Packer binary; current guest templates require an x64 host and Debian amd64 or Windows 11 x64 media. macOS hosts use VirtualBox; an Apple Hypervisor adapter is not implemented.
111
+
112
+ The shared installer flow boots your original ISO with the backend's Packer builder, configures the OS, reboots and waits **60 seconds** before desktop post-install setup. Debian GNOME automatically logs into the public sandbox account `vboxuser` / `password123!`; Windows uses the same public sandbox account for first-login setup and still requires your own valid license. Use these defaults only for an authorized sandbox. The guest reports successful post-install setup to a per-build token endpoint before shutting down for golden-image export. No persistent SSH/WinRM communicator is installed by Packer. Resolution still requires fresh framebuffer verification.
113
+
114
+ VirtualBox is the reference profile. Hyper-V changes generation/switch/TPM settings; KVM changes QEMU acceleration, disk, firmware and network settings. These profiles share installation and post-install scripts. A successful `packer validate` is not proof of a complete guest installation. Check each image's build status and `packer.log`; failed partial builds are preserved. Hyper-V requires Windows permissions and the Default Switch; KVM requires Linux, QEMU/libvirt, virt-install and OVMF, plus swtpm for Windows. Windows answer media is generated automatically by an isolated, pinned pycdlib helper (installed on first use); no ADK/xorriso installation is needed. VAMP creates a separate answer-media ISO; your installation ISO is not rewritten. Allow guest access to the setup server on TCP 8421 and the per-build Packer HTTP/completion ports.
115
+
116
+ VSIX and MCP use the same Packer runner. VM creation returns a queued build, not a completed VM. The live VM is deployed after OS installation, post-install confirmation and export succeed. In VM Manager, **Golden images** shows build status, absolute folder and image-file paths, byte sizes, and logs. Use **Open folder** or **Delete golden image**. Deletion asks for confirmation and is disabled while a build is active.
117
+
118
+ Storage defaults to `~/.vamp` (`%USERPROFILE%\.vamp` on Windows), overridable with `VAMP_HOME`:
119
+
120
+ - `tools/packer/`: downloaded CLI, official plugins and cache.
121
+ - `golden/<image-id>/artifact/`: golden OVA/QCOW2/Hyper-V export; builds can consume many GB.
122
+ - `golden/<image-id>/packer.log` and `image.json`: build evidence and status.
123
+ - `vms/<backend>/<name>/`: separately deployed live VM disks. Deleting a golden image does not delete these disks.
124
+
125
+ MCP exposes `vm_packer_prepare`, `vm_create`, `vm_golden_images` and `vm_golden_image_delete`; the remote host server exposes corresponding `remote_*` tools. Inspect the image ID, path and size before explicitly confirming deletion. Remote paths are on the host running that MCP server.
126
+
127
+ Manual preparation (Python 3.11+):
128
+
129
+ ```sh
130
+ python backends/packer/runner.py prepare --backend virtualbox
131
+ python backends/packer/runner.py images
132
+ ```
133
+
134
+ Packer and its plugins are downloaded separately under their own licenses; they are not bundled as VAMP code. Official documentation: [Packer installation](https://developer.hashicorp.com/packer/install), [plugin initialization](https://developer.hashicorp.com/packer/docs/commands/init), [VirtualBox](https://developer.hashicorp.com/packer/integrations/hashicorp/virtualbox), [Hyper-V](https://developer.hashicorp.com/packer/integrations/hashicorp/hyperv), [QEMU](https://developer.hashicorp.com/packer/integrations/hashicorp/qemu).
135
+
136
+ Guest resolution reset shortcuts are installed during setup: **Windows Desktop:** double-click `Set-Resolution-1920x1080.cmd` (companion `Set-Resolution-1920x1080.ps1`); **Debian home:** run `~/set-resolution-1920x1080.sh` in the guest terminal. All usage text is in English. These shortcuts apply Full HD to the guest and report failure if the display driver cannot provide it.
137
+
138
+ Windows guest setup and display-reset scripts request administrator PowerShell when needed. Approve the UAC prompt. The elevated process runs `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Unrestricted -Force` before the script. MCP and VSIX share the same Ctrl+Shift+Enter / UAC Left+Enter bootstrap. Script execution policy changes apply to that process.
139
+
140
+ Windows guest setup now installs **VirtualBox Guest Additions** from matching vendor media, or downloads the official **virtio-win** ISO for KVM and installs the signed guest driver packages (and QEMU guest agent when provided). A privileged scheduled task resumes setup after the driver reboot, waits 60 seconds and applies Full HD before reporting completion. Packer does not treat the initial OS install or a requested reboot as completed setup. Driver media is stored in the managed tool cache; binaries retain their vendor licenses and are downloaded separately.
141
+
142
+ Ubuntu KVM profiles read the host's osinfo-db XML, then use `virt-install --dry-run --print-xml` to resolve virt-manager hardware defaults. Install `osinfo-db`, `libosinfo-bin`, `virtinst`, `qemu-system-x86`, `qemu-utils`, `ovmf` and `swtpm`. The generated `osinfo-profile.json` and `virt-manager-profile.xml` are preserved beside each Packer build. Builds use QEMU user NAT; deployed guests use user networking for `qemu:///session` or the existing `default` network/storage pool for `qemu:///system`. KVM and Hyper-V hardware testing is left to the user for this release.
@@ -1,27 +1,32 @@
1
- # First-party MIT and third-party notices
2
-
3
- The root [MIT license](LICENSE) applies to original project code and documentation unless a file states otherwise. It does not relicense third-party source, models, libraries or virtual machine products.
4
-
5
- ## Existing vision components
6
-
7
- - Microsoft OmniParser v2 `icon_detect/model.pt`: [upstream](https://huggingface.co/microsoft/OmniParser-v2.0), original AGPL-3.0 license preserved at [models/OMNIPARSER-LICENSE](models/OMNIPARSER-LICENSE). Weight files are downloaded separately and excluded from Git. The pinned source revision/hash is in `models/manifest.json`.
8
- - Ultralytics is a separately installed dependency under its upstream license (AGPL-3.0 or an applicable commercial license). Root MIT licensing does not remove that dependency's obligations. Distribution of a combined work must account for the relevant AGPL conditions; do not describe an entire bundled vision stack as MIT-only.
9
- - Other Python/Node packages keep their own licenses. Installing dependencies is not a license grant from this project; preserve their notices when distributing them.
10
-
11
- ## Virtualization products
12
-
13
- VirtualBox, Hyper-V, QEMU, SPICE and their SDKs/binaries are not relicensed by this project. This repository does not bundle hypervisor binaries or a VirtualBox Extension Pack. A third-party MCP adapter's MIT license does not grant rights to a separately licensed hypervisor/Extension Pack.
14
-
15
- Any vendored adapter must include its original LICENSE and source URL, pinned revision, file hashes and modification description alongside the imported source. Platform-specific notices are documented in that backend's README.
16
-
17
- ## Vendored VirtualBox adapter
18
-
19
- [chryaner/mcp-virtualbox](https://github.com/chryaner/mcp-virtualbox), revision `b51349126d34824cb211d412fc815f1e2e4ed2a5`, MIT, Copyright (c) 2026 mcp-virtualbox contributors. Its full [LICENSE](third_party/mcp-virtualbox/LICENSE) is retained. Selected source/build/test files are included in `third_party/mcp-virtualbox`; original hashes and local dependency changes are recorded in `PROVENANCE.json`. Integration and test limits are described in [the backend README](backends/virtualbox/README.md).
20
-
21
- ## Independent guest recorder (GPL-3.0)
22
-
23
- [axel-magard/PyAutoGUI-Recorder](https://github.com/axel-magard/PyAutoGUI-Recorder), revision `6cd48a3bee4ef4dd382e3484feaa4360a37a0a5d`, is preserved unmodified with its full [GPL-3.0 LICENSE](third_party/pyautogui-recorder/LICENSE), Python source and image assets. Original hashes are in its `PROVENANCE.json`. The MIT host installer packages this independent program for execution in a guest process; it does not import or relicense its code. Distributed recorder source and notices must remain available under its original license. The VSIX includes that source. Bundled Node dependency notices are generated under the extension's `dist/notices`.
24
-
25
- ## VAMP guest recorder adaptation
26
-
27
- `guest_setup/recorder/vamp-recorder.py` is an explicitly GPL-3.0-only UI adaptation of the recorder workflow, not covered by the root MIT license. It is distributed as source with `RECORDER-LICENSE` (full GPL-3.0 text) and the original recorder source/provenance. It uses thread-safe UI queues, explicit user recording controls and shared-folder saving. The host/server code remains separately MIT licensed.
1
+ # First-party MIT and third-party notices
2
+
3
+ The root [MIT license](LICENSE) applies to original project code and documentation unless a file states otherwise. It does not relicense third-party source, models, libraries or virtual machine products.
4
+
5
+ ## Existing vision components
6
+
7
+ - Microsoft OmniParser v2 `icon_detect/model.pt`: [upstream](https://huggingface.co/microsoft/OmniParser-v2.0), original AGPL-3.0 license preserved at [models/OMNIPARSER-LICENSE](models/OMNIPARSER-LICENSE). Weight files are downloaded separately and excluded from Git. The pinned source revision/hash is in `models/manifest.json`.
8
+ - Ultralytics is a separately installed dependency under its upstream license (AGPL-3.0 or an applicable commercial license). Root MIT licensing does not remove that dependency's obligations. Distribution of a combined work must account for the relevant AGPL conditions; do not describe an entire bundled vision stack as MIT-only.
9
+ - Other Python/Node packages keep their own licenses. Installing dependencies is not a license grant from this project; preserve their notices when distributing them.
10
+
11
+ ## Virtualization products
12
+
13
+ VirtualBox, Hyper-V, QEMU, SPICE and their SDKs/binaries are not relicensed by this project. This repository does not bundle hypervisor binaries or a VirtualBox Extension Pack. A third-party MCP adapter's MIT license does not grant rights to a separately licensed hypervisor/Extension Pack.
14
+
15
+ Any vendored adapter must include its original LICENSE and source URL, pinned revision, file hashes and modification description alongside the imported source. Platform-specific notices are documented in that backend's README.
16
+
17
+ ## Vendored VirtualBox adapter
18
+
19
+ [chryaner/mcp-virtualbox](https://github.com/chryaner/mcp-virtualbox), revision `b51349126d34824cb211d412fc815f1e2e4ed2a5`, MIT, Copyright (c) 2026 mcp-virtualbox contributors. Its full [LICENSE](third_party/mcp-virtualbox/LICENSE) is retained. Selected source/build/test files are included in `third_party/mcp-virtualbox`; original hashes and local dependency changes are recorded in `PROVENANCE.json`. Integration and test limits are described in [the backend README](backends/virtualbox/README.md).
20
+
21
+ ## Independent guest recorder (GPL-3.0)
22
+
23
+ [axel-magard/PyAutoGUI-Recorder](https://github.com/axel-magard/PyAutoGUI-Recorder), revision `6cd48a3bee4ef4dd382e3484feaa4360a37a0a5d`, is preserved unmodified with its full [GPL-3.0 LICENSE](third_party/pyautogui-recorder/LICENSE), Python source and image assets. Original hashes are in its `PROVENANCE.json`. The MIT host installer packages this independent program for execution in a guest process; it does not import or relicense its code. Distributed recorder source and notices must remain available under its original license. The VSIX includes that source. Bundled Node dependency notices are generated under the extension's `dist/notices`.
24
+
25
+ ## VAMP guest recorder adaptation
26
+
27
+ `guest_setup/recorder/vamp-recorder.py` is an explicitly GPL-3.0-only UI adaptation of the recorder workflow, not covered by the root MIT license. It is distributed as source with `RECORDER-LICENSE` (full GPL-3.0 text) and the original recorder source/provenance. It uses thread-safe UI queues, explicit user recording controls and shared-folder saving. The host/server code remains separately MIT licensed.
28
+
29
+
30
+ ## HashiCorp Packer and official hypervisor plugins
31
+
32
+ New VM installation invokes separately downloaded HashiCorp Packer CLI and official VirtualBox, Hyper-V or QEMU plugins. These binaries are not bundled in VAMP or covered by VAMP's MIT license. Packer CLI and each plugin retain their upstream licenses and notices. See https://developer.hashicorp.com/packer and the respective HashiCorp plugin repositories. VAMP pins the CLI archive SHA-256 and plugin versions in backends/packer/policy.json.
package/bin/vamp-mcp.mjs CHANGED
@@ -1,37 +1,37 @@
1
- #!/usr/bin/env node
2
- import path from 'node:path';
3
- import os from 'node:os';
4
- import {fileURLToPath, pathToFileURL} from 'node:url';
5
- import {readFileSync} from 'node:fs';
6
- const here=path.dirname(fileURLToPath(import.meta.url));
7
- const runtime=path.resolve(here,'../runtime');
8
- const [command='virtualbox',...args]=process.argv.slice(2);
9
- if (command==='--version' || command==='-v') {
10
- console.log(JSON.parse(readFileSync(path.join(here,'../package.json'),'utf8')).version);
11
- } else if (command==='--help' || command==='-h') {
12
- console.log(`VAMP MCP — independent stdio servers
13
- Usage: vamp-mcp [virtualbox|kvm|library|remote] [remote options]
14
- virtualbox Local VirtualBox MCP (default); needs VirtualBox and Python 3.11+
15
- kvm KVM/libvirt inventory, creation and control (Debian automatic install)
16
- library Reviewed RPA search/replay; VAMP_RPA_REGISTRY selects saved RPAs
17
- remote KVM/VirtualBox host MCP; pass --backend kvm or --backend virtualbox
18
- --version Package version
19
- Python: RPA_HOST_PYTHON (defaults to python3, or python on Windows).
20
- Remote controls the host running this process; use SSH to run it on another host.
21
- No VM, OS, hypervisor, Python environment or Vault is installed automatically.`);
22
- } else {
23
- const entries={virtualbox:'virtualbox',library:'library',kvm:'remote_ssh',remote:'remote_ssh'};
24
- if (!Object.hasOwn(entries,command) || (!['remote','kvm'].includes(command) && args.length)) {
25
- console.error('Invalid command or arguments. Run vamp-mcp --help.');
26
- process.exitCode=2;
27
- } else {
28
- process.env.RPA_HOST_PYTHON ||= process.platform==='win32'?'python':'python3';
29
- process.env.PYTHON_PATH ||= process.env.RPA_HOST_PYTHON;
30
- process.env.VAMP_RPA_REGISTRY ||= path.join(os.homedir(),'.vamp','rpa-catalog');
31
- process.env.VAMP_REMOTE_REPO ||= runtime;
32
- process.env.VAMP_REMOTE_PYTHON ||= process.env.RPA_HOST_PYTHON;
33
- // The existing remote server reads argv directly. Strip our subcommand.
34
- process.argv=[process.argv[0],path.join(runtime,'backends',entries[command],'server.mjs'),...args,...(command==='kvm'?['--backend','kvm']:[])];
35
- await import(pathToFileURL(process.argv[1]).href);
36
- }
37
- }
1
+ #!/usr/bin/env node
2
+ import path from 'node:path';
3
+ import os from 'node:os';
4
+ import {fileURLToPath, pathToFileURL} from 'node:url';
5
+ import {readFileSync} from 'node:fs';
6
+ const here=path.dirname(fileURLToPath(import.meta.url));
7
+ const runtime=path.resolve(here,'../runtime');
8
+ const [command='virtualbox',...args]=process.argv.slice(2);
9
+ if (command==='--version' || command==='-v') {
10
+ console.log(JSON.parse(readFileSync(path.join(here,'../package.json'),'utf8')).version);
11
+ } else if (command==='--help' || command==='-h') {
12
+ console.log(`VAMP MCP — independent stdio servers
13
+ Usage: vamp-mcp [virtualbox|kvm|library|remote] [remote options]
14
+ virtualbox Local VM MCP with Packer (VirtualBox default); needs Python 3.11+
15
+ kvm KVM/libvirt control and Packer OS/post-install setup on Ubuntu
16
+ library Reviewed RPA search/replay; VAMP_RPA_REGISTRY selects saved RPAs
17
+ remote KVM/VirtualBox host MCP; pass --backend kvm or --backend virtualbox
18
+ --version Package version
19
+ Python: RPA_HOST_PYTHON (defaults to python3, or python on Windows).
20
+ Remote controls the host running this process; use SSH to run it on another host.
21
+ No VM, OS, hypervisor, Python environment or Vault is installed automatically.`);
22
+ } else {
23
+ const entries={virtualbox:'virtualbox',library:'library',kvm:'remote_ssh',remote:'remote_ssh'};
24
+ if (!Object.hasOwn(entries,command) || (!['remote','kvm'].includes(command) && args.length)) {
25
+ console.error('Invalid command or arguments. Run vamp-mcp --help.');
26
+ process.exitCode=2;
27
+ } else {
28
+ process.env.RPA_HOST_PYTHON ||= process.platform==='win32'?'python':'python3';
29
+ process.env.PYTHON_PATH ||= process.env.RPA_HOST_PYTHON;
30
+ process.env.VAMP_RPA_REGISTRY ||= path.join(os.homedir(),'.vamp','rpa-catalog');
31
+ process.env.VAMP_REMOTE_REPO ||= runtime;
32
+ process.env.VAMP_REMOTE_PYTHON ||= process.env.RPA_HOST_PYTHON;
33
+ // The existing remote server reads argv directly. Strip our subcommand.
34
+ process.argv=[process.argv[0],path.join(runtime,'backends',entries[command],'server.mjs'),...args,...(command==='kvm'?['--backend','kvm']:[])];
35
+ await import(pathToFileURL(process.argv[1]).href);
36
+ }
37
+ }
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 mcp-virtualbox contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 mcp-virtualbox contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -1,37 +1,37 @@
1
- {
2
- "source": "https://github.com/chryaner/mcp-virtualbox",
3
- "revision": "b51349126d34824cb211d412fc815f1e2e4ed2a5",
4
- "license": "MIT",
5
- "modifications": "Source files unchanged. package.json upgrades zod to ^4.6.7 and package-lock.json refreshes compatible dependencies to address npm audit findings; original hashes below are retained.",
6
- "sha256": {
7
- "LICENSE": "a1478b1ed56a83fd9ae8bc092381c2fa2473d15669b9c6e3e4d21d8ef77db774",
8
- "README.md": "14079b20dd9035b368f2767ec08de87d4f39741be038c102a7647707a18c207e",
9
- "package-lock.json": "1aab3ac569d6e8b3878bc9288bfa49940277c9b9d06b77b23328c897bb3080fe",
10
- "package.json": "f6ce1e680568b7a84cbda3d047046fa741913d2771d6eeed39bef17be81bbef7",
11
- "scripts/mouse_click.py": "e7bdc74936a46185be94ce9a7d8b1a687266d18cf1d9a82159e517e623fe87e6",
12
- "src/index.ts": "724477c07ec3709038680003d85432f29e72e01f781bbd04515762025e143e5d",
13
- "src/scancodes.test.ts": "8b553e87b46cae75318aaae5b0459f34f4be6e6c207b65d6f037664758a6f0eb",
14
- "src/scancodes.ts": "240cf9b487808004edad67d57edca3b35f8f9004a7302e615ebeafc2d208e688",
15
- "src/tools/display.test.ts": "2f2648bf2cd117237f8060c077cbacf2d362bbfb34907f51358f86c77b8558dc",
16
- "src/tools/display.ts": "e8094ef9153da58dca55d8b03412b04afe7fc4e248ff45ac8cd4e49ba8d226a2",
17
- "src/tools/guest-control.test.ts": "d46108bcb6fe59214a2dea8e8f49e3bc31eb774dcdca98b7f894c61c4e09b155",
18
- "src/tools/guest-control.ts": "e2de9476be733eb63de1a82a56056bb3f912a9ae2fcfd664b5d1d9a795866219",
19
- "src/tools/input.test.ts": "07ce6c54d224ade7d7aad8aa4b96fc7f5a8ea590d79347122cd5d18084ab5b37",
20
- "src/tools/input.ts": "2dc56ad387e108728fc6121d681799711f485256877044ac10a50d741120ce9c",
21
- "src/tools/knowledge.test.ts": "75fafb5c7aba2df08bf0e632d579bd45e1485563f688bbb4ff1f7cfe296136a4",
22
- "src/tools/knowledge.ts": "2b876287ef21617b7e9c1af7e62901335451333a7917bbf21a95b96e4ef6280b",
23
- "src/tools/lifecycle.test.ts": "e3876d908d5a504847c0181a8ba3bd0834db8e1118fb384ddc5606535696613e",
24
- "src/tools/lifecycle.ts": "c937a764874d89c21ab1b9b57e7ff880ac02fe285fd3d4c038f888497950a681",
25
- "src/tools/network-exec.test.ts": "51ff0a60c26a595b1b9e2085258386af46f11e031636212170b70a4c13fe84aa",
26
- "src/tools/network-exec.ts": "54501de073106ef26330f8e87b14a677265fc9b52adffae95168d460d1f8db4b",
27
- "src/types.ts": "b1fddc295d2a1581e242ee5c3beef83d9e93e646d12b8d568fe76c2b0ac9c20f",
28
- "src/vbox.test.ts": "b006248019fd671c45b877825c07359215ffaaf6da0602ef72cea3fcd633f63e",
29
- "src/vbox.ts": "53f0757141fde327169f87fd0b1a1ebf6c1f46835691a3ff74682da00f4bd1e0",
30
- "tsconfig.json": "458b0ce8cb41f22fad5a1ddc521f1f1afc2956bbb338b360b96854baec1d58ba",
31
- "vitest.config.ts": "aa7858f05b2261348f1502fa076550b0930672e0df3f054a22e8a8d9b68fb32e"
32
- },
33
- "modified_sha256": {
34
- "package.json": "4c52d63e261b9220c1f81d5ebf4b620253d793ae615c433cabab10bc8991d38f",
35
- "package-lock.json": "ac616d4cb0b4c4e7177b2c255ae52396b4ef0c69df8927bcd6fc2b76c7ba27b6"
36
- }
37
- }
1
+ {
2
+ "source": "https://github.com/chryaner/mcp-virtualbox",
3
+ "revision": "b51349126d34824cb211d412fc815f1e2e4ed2a5",
4
+ "license": "MIT",
5
+ "modifications": "Source files unchanged. package.json upgrades zod to ^4.6.7 and package-lock.json refreshes compatible dependencies to address npm audit findings; original hashes below are retained.",
6
+ "sha256": {
7
+ "LICENSE": "a1478b1ed56a83fd9ae8bc092381c2fa2473d15669b9c6e3e4d21d8ef77db774",
8
+ "README.md": "14079b20dd9035b368f2767ec08de87d4f39741be038c102a7647707a18c207e",
9
+ "package-lock.json": "1aab3ac569d6e8b3878bc9288bfa49940277c9b9d06b77b23328c897bb3080fe",
10
+ "package.json": "f6ce1e680568b7a84cbda3d047046fa741913d2771d6eeed39bef17be81bbef7",
11
+ "scripts/mouse_click.py": "e7bdc74936a46185be94ce9a7d8b1a687266d18cf1d9a82159e517e623fe87e6",
12
+ "src/index.ts": "724477c07ec3709038680003d85432f29e72e01f781bbd04515762025e143e5d",
13
+ "src/scancodes.test.ts": "8b553e87b46cae75318aaae5b0459f34f4be6e6c207b65d6f037664758a6f0eb",
14
+ "src/scancodes.ts": "240cf9b487808004edad67d57edca3b35f8f9004a7302e615ebeafc2d208e688",
15
+ "src/tools/display.test.ts": "2f2648bf2cd117237f8060c077cbacf2d362bbfb34907f51358f86c77b8558dc",
16
+ "src/tools/display.ts": "e8094ef9153da58dca55d8b03412b04afe7fc4e248ff45ac8cd4e49ba8d226a2",
17
+ "src/tools/guest-control.test.ts": "d46108bcb6fe59214a2dea8e8f49e3bc31eb774dcdca98b7f894c61c4e09b155",
18
+ "src/tools/guest-control.ts": "e2de9476be733eb63de1a82a56056bb3f912a9ae2fcfd664b5d1d9a795866219",
19
+ "src/tools/input.test.ts": "07ce6c54d224ade7d7aad8aa4b96fc7f5a8ea590d79347122cd5d18084ab5b37",
20
+ "src/tools/input.ts": "2dc56ad387e108728fc6121d681799711f485256877044ac10a50d741120ce9c",
21
+ "src/tools/knowledge.test.ts": "75fafb5c7aba2df08bf0e632d579bd45e1485563f688bbb4ff1f7cfe296136a4",
22
+ "src/tools/knowledge.ts": "2b876287ef21617b7e9c1af7e62901335451333a7917bbf21a95b96e4ef6280b",
23
+ "src/tools/lifecycle.test.ts": "e3876d908d5a504847c0181a8ba3bd0834db8e1118fb384ddc5606535696613e",
24
+ "src/tools/lifecycle.ts": "c937a764874d89c21ab1b9b57e7ff880ac02fe285fd3d4c038f888497950a681",
25
+ "src/tools/network-exec.test.ts": "51ff0a60c26a595b1b9e2085258386af46f11e031636212170b70a4c13fe84aa",
26
+ "src/tools/network-exec.ts": "54501de073106ef26330f8e87b14a677265fc9b52adffae95168d460d1f8db4b",
27
+ "src/types.ts": "b1fddc295d2a1581e242ee5c3beef83d9e93e646d12b8d568fe76c2b0ac9c20f",
28
+ "src/vbox.test.ts": "b006248019fd671c45b877825c07359215ffaaf6da0602ef72cea3fcd633f63e",
29
+ "src/vbox.ts": "53f0757141fde327169f87fd0b1a1ebf6c1f46835691a3ff74682da00f4bd1e0",
30
+ "tsconfig.json": "458b0ce8cb41f22fad5a1ddc521f1f1afc2956bbb338b360b96854baec1d58ba",
31
+ "vitest.config.ts": "aa7858f05b2261348f1502fa076550b0930672e0df3f054a22e8a8d9b68fb32e"
32
+ },
33
+ "modified_sha256": {
34
+ "package.json": "4c52d63e261b9220c1f81d5ebf4b620253d793ae615c433cabab10bc8991d38f",
35
+ "package-lock.json": "ac616d4cb0b4c4e7177b2c255ae52396b4ef0c69df8927bcd6fc2b76c7ba27b6"
36
+ }
37
+ }