vamp-mcp 0.2.0 → 0.2.4
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/LICENSE +21 -21
- package/README.md +144 -107
- package/THIRD_PARTY_NOTICES.md +32 -27
- package/bin/vamp-mcp.mjs +37 -37
- package/notices/mcp-virtualbox-LICENSE +21 -21
- package/notices/mcp-virtualbox-PROVENANCE.json +37 -37
- package/package.json +51 -17
- package/runtime/backends/common/Test-Environment.ps1 +7 -6
- package/runtime/backends/common/guest-install.json +58 -0
- package/runtime/backends/common/guest_install.py +57 -0
- package/runtime/backends/common/host-support.cjs +16 -0
- package/runtime/backends/common/packer.cjs +16 -0
- package/runtime/backends/hyperv/scripts/Manage-Desktop.ps1 +40 -67
- package/runtime/backends/hyperv/scripts/Send-InstallerBoot.ps1 +25 -0
- package/runtime/backends/kvm/debian-preseed.cfg +35 -35
- package/runtime/backends/library/registry.py +77 -77
- package/runtime/backends/library/replay.py +154 -154
- package/runtime/backends/packer/answer_media.py +16 -0
- package/runtime/backends/packer/deploy-hyperv.ps1 +10 -0
- package/runtime/backends/packer/drivers.py +49 -0
- package/runtime/backends/packer/hyperv-network.ps1 +10 -0
- package/runtime/backends/packer/images.py +75 -0
- package/runtime/backends/packer/osinfo.py +113 -0
- package/runtime/backends/packer/policy.json +15 -0
- package/runtime/backends/packer/runner.py +224 -0
- package/runtime/backends/packer/templates.py +118 -0
- package/runtime/backends/packer/toolchain.py +80 -0
- package/runtime/backends/remote_ssh/server.mjs +310 -93
- package/runtime/backends/virtualbox/desktop.cjs +37 -0
- package/runtime/backends/virtualbox/display.py +101 -101
- package/runtime/backends/virtualbox/history.py +139 -139
- package/runtime/backends/virtualbox/mouse_click.py +15 -15
- package/runtime/backends/virtualbox/mouse_move.py +18 -18
- package/runtime/backends/virtualbox/profiles.json +46 -46
- package/runtime/backends/virtualbox/provision.py +238 -197
- package/runtime/backends/virtualbox/recording_listener.py +29 -29
- package/runtime/backends/virtualbox/recordings.py +39 -39
- package/runtime/backends/virtualbox/requirements.txt +7 -7
- package/runtime/backends/virtualbox/rpas/debian_first_boot/manifest.json +1 -1
- package/runtime/backends/virtualbox/rpas/debian_first_boot/run.robot +13 -13
- package/runtime/backends/virtualbox/rpas/debian_first_boot/workflow.py +75 -75
- package/runtime/backends/virtualbox/rpas/observe/manifest.json +7 -7
- package/runtime/backends/virtualbox/rpas/observe/run.robot +13 -13
- package/runtime/backends/virtualbox/rpas/observe/workflow.py +14 -14
- package/runtime/backends/virtualbox/server.mjs +288 -237
- package/runtime/backends/virtualbox/setup_windows_sdk.py +58 -58
- package/runtime/backends/virtualbox/shares.py +68 -68
- package/runtime/backends/virtualbox/snapshots.py +53 -53
- package/runtime/backends/virtualbox/transfers.py +89 -89
- package/runtime/backends/virtualbox/vnc.py +61 -61
- package/runtime/guest_keys.py +13 -13
- package/runtime/guest_setup/http/debian-preseed.cfg +39 -0
- package/runtime/guest_setup/http/postdeb.sh +50 -3
- package/runtime/guest_setup/http/postwin.ps1 +53 -28
- package/runtime/guest_setup/http/setup-all.ps1 +25 -25
- package/runtime/guest_setup/http/setup-win.cmd +7 -7
- package/runtime/guest_setup/http/setup.ps1 +44 -29
- package/runtime/guest_setup/kvm/setup-windows.ps1 +52 -52
- package/runtime/guest_setup/recorder/README.txt +12 -12
- package/runtime/guest_setup/recorder/RECORDER-LICENSE +674 -674
- package/runtime/guest_setup/recorder/RECORDING-GUIDE.txt +31 -31
- package/runtime/guest_setup/recorder/apply-display.py +41 -41
- package/runtime/guest_setup/recorder/configure-debian-mirrors.py +62 -62
- package/runtime/guest_setup/recorder/configure-gdm.py +23 -0
- package/runtime/guest_setup/recorder/configure-session.ps1 +14 -0
- package/runtime/guest_setup/recorder/gnome-display.py +60 -60
- package/runtime/guest_setup/recorder/install-display-startup.py +67 -39
- package/runtime/guest_setup/recorder/install-hypervisor-drivers.ps1 +34 -0
- package/runtime/guest_setup/recorder/install-resolution-shortcut.ps1 +36 -0
- package/runtime/guest_setup/recorder/postwin.cmd +10 -10
- package/runtime/guest_setup/recorder/prepare-recording.py +30 -30
- package/runtime/guest_setup/recorder/requirements-recorder.txt +2 -2
- package/runtime/guest_setup/recorder/session-policy.py +22 -0
- package/runtime/guest_setup/recorder/set-resolution-registry.ps1 +40 -0
- package/runtime/guest_setup/recorder/setup-user.py +53 -53
- package/runtime/guest_setup/recorder/setup-win.cmd +4 -60
- package/runtime/guest_setup/recorder/setup.ps1 +112 -81
- package/runtime/guest_setup/recorder/setup.sh +1 -0
- package/runtime/guest_setup/recorder/vamp-recorder.py +148 -148
- package/runtime/guest_setup/recorder/verify-recorder.py +4 -4
- package/runtime/guest_setup/recorder/windows-display.py +76 -76
- package/runtime/guest_setup/requirements.txt +2 -2
- package/runtime/guest_setup/setup-all.ps1 +35 -35
- package/runtime/guest_setup/vault/Install-VCRuntime.ps1 +26 -26
- package/runtime/guest_setup/vault/setup-guest-vault.ps1 +148 -148
- package/runtime/recording_converter.py +230 -230
- package/runtime/requirements-mcp.txt +11 -11
- package/runtime/rpas/README.md +161 -161
- package/runtime/rpas/captcha_handoff/manifest.json +27 -27
- package/runtime/rpas/captcha_handoff/run.robot +16 -16
- package/runtime/rpas/captcha_handoff/workflow.py +11 -11
- package/runtime/rpas/common.resource +26 -26
- package/runtime/rpas/debian_update/manifest.json +27 -27
- package/runtime/rpas/debian_update/run.robot +17 -17
- package/runtime/rpas/debian_update/workflow.py +13 -13
- package/runtime/rpas/desktop_control/manifest.json +26 -26
- package/runtime/rpas/desktop_control/run.robot +27 -27
- package/runtime/rpas/desktop_control/workflow.py +51 -51
- package/runtime/rpas/firefox_launch/manifest.json +27 -27
- package/runtime/rpas/firefox_launch/run.robot +15 -15
- package/runtime/rpas/firefox_launch/workflow.py +25 -25
- package/runtime/rpas/firefox_naver/manifest.json +27 -27
- package/runtime/rpas/firefox_naver/run.robot +21 -21
- package/runtime/rpas/firefox_naver/workflow.py +28 -28
- package/runtime/rpas/kvm_validation/README.md +11 -11
- package/runtime/rpas/kvm_validation/manifest.json +28 -28
- package/runtime/rpas/kvm_validation/run.robot +30 -30
- package/runtime/rpas/kvm_validation/workflow.py +91 -91
- package/runtime/rpas/manifest.schema.json +105 -105
- package/runtime/rpas/naver_login/login.robot +25 -25
- package/runtime/rpas/naver_login/manifest.json +33 -33
- package/runtime/rpas/naver_login/run.robot +20 -20
- package/runtime/rpas/naver_login/workflow.py +32 -32
- package/runtime/rpas/windows_naver_recorded/README.md +24 -24
- package/runtime/rpas/windows_naver_recorded/conversion.json +25 -25
- package/runtime/rpas/windows_naver_recorded/manifest.json +28 -28
- package/runtime/rpas/windows_naver_recorded/run.robot +37 -37
- package/runtime/rpas/windows_naver_recorded/workflow.py +32 -32
- package/runtime/scripts/build_recorder_media.py +39 -39
- package/runtime/scripts/macos/setup-host.sh +0 -0
- package/runtime/scripts/script_server.py +571 -517
- package/runtime/skills/vamp-rpa-ui-checks/SKILL.md +26 -0
- package/runtime/skills/vamp-rpa-ui-checks/agents/openai.yaml +4 -0
- package/runtime/skills/vamp-rpa-ui-checks/references/display.md +12 -0
- package/runtime/skills/vamp-rpa-ui-checks/references/user-guide.md +51 -0
- package/runtime/skills/vamp-ui-cleanup/SKILL.md +15 -0
- package/runtime/skills/vamp-ui-cleanup/agents/openai.yaml +4 -0
- package/runtime/skills/vamp-ui-validation/SKILL.md +27 -0
- package/runtime/skills/vamp-ui-validation/agents/openai.yaml +4 -0
- package/runtime/third_party/mcp-virtualbox/scripts/mouse_click.py +65 -65
- package/runtime/third_party/pyautogui-recorder/LICENSE +674 -674
- package/runtime/third_party/pyautogui-recorder/PROVENANCE.json +16 -16
- package/runtime/third_party/pyautogui-recorder/PyAutoGuiRecorder.py +169 -169
- 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,144 @@
|
|
|
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
|
-
|
|
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.
|
|
143
|
+
|
|
144
|
+
Windows setup finishes with an elevated direct registry update to 1920x1080 (`PrimSurfSize.cx/cy` and `ActiveSize.cx/cy`) for the guest display configurations, on VirtualBox, KVM and Hyper-V. The Desktop reset script performs the same update before applying the display mode. Previous registry values are backed up under `%ProgramData%\VAMP\display-registry\backups`. A compatible guest display driver is still required.
|
package/THIRD_PARTY_NOTICES.md
CHANGED
|
@@ -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
|
|
15
|
-
kvm KVM/libvirt
|
|
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
|
+
}
|