@luaward/mcp 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,11 +2,12 @@
2
2
 
3
3
  Official **Luaward Hybrid Model Context Protocol (MCP)** stdio bridge for Claude Desktop, Cursor, Windsurf, Claude Code, and local AI coding assistants.
4
4
 
5
- `@luaward/mcp` connects your AI client to three cooperating layers:
5
+ `@luaward/mcp` connects your AI client to four cooperating layers:
6
6
 
7
- 1. **Luaward Cloud MCP (`https://luaward.com/mcp`)**: full Luau script protection, licensing, live in-game agent recipes (`run_and_collect`, `benchmark_session`, `cleanup_run`, `inspect_session_capabilities`, `ui_controls`, `gui_snapshot`, `remotes`, `search_scripts`, `scripts_read`, `inspect`, `exec`, `spy_start`, `player_state`), and workspace script deployment.
7
+ 1. **Luaward Cloud MCP (`https://luaward.com/mcp`)**: full Luau script protection, licensing, live in-game agent recipes (`run_and_collect`, `benchmark_session`, `cleanup_run`, `inspect_session_capabilities`, `ui_controls`, `gui_snapshot`, `remotes`, `search_scripts`, `scripts_read`, `inspect`, `exec`, `get_result`, `spy_start`, `player_state`), and workspace script deployment.
8
8
  2. **Potassium Local MCP Bridge (`http://127.0.0.1:8225/mcp`)**: zero-touch auto-inject of the Luaward in-game agent whenever Potassium has an attached Roblox client, local `editor_tabs` sync (with `luaward_scratch.luau` tab reuse to avoid Potassium's unclosable dirty tabs), and local `file_path` loading for `run_and_collect`, `exec`, `create_script`, and `deploy_script`.
9
- 3. **Windows Computer Use & OS Lifecycle Automation**: Win32 `SendInput` (Roblox UI hover-wake `dx=1` and Raw Input `WM_INPUT` 3D camera rotation, ScanCode & Unicode keyboard), Windows UI Automation tree inspection (`desktop_ui_tree`), OS PNG screenshots (`desktop_screenshot`), window management (`desktop_window`), Roblox/Potassium process lifecycle & crash recovery (`desktop_launch`), and hybrid in-game `#n` + Win32 clicking (`os_click`).
9
+ 3. **Windows Computer Use & OS Lifecycle Automation**: Win32 `SendInput` (Roblox UI hover-wake `dx=1` and Raw Input `WM_INPUT` 3D camera rotation, ScanCode & Unicode keyboard), Windows UI Automation tree inspection (`desktop_ui_tree`), OS PNG screenshots (`desktop_screenshot` with `WindowFromPoint` occlusion detection + `PrintWindow` fallback), window management (`desktop_window` with `AttachThreadInput` foreground focus recovery), Roblox/Potassium process lifecycle & crash recovery (`desktop_launch`), and foreground-verified hybrid `#n` + Win32 clicking (`os_click`).
10
+ 4. **Roblox Studio MCP Bridge (`%LOCALAPPDATA%\Roblox\mcp.bat`) & Visual Comparison**: bidirectional live-game to Roblox Studio workflows (`studio_mirror_remotes`, `studio_mirror_gui`, `studio_diff`, `studio_to_live`, `studio_publish`, `live_scripts_to_studio`) with automatic `studio_id` selection, `execute_luau` `datamodel_type` (`Edit` / `Client` / `Server`), automatic Cloud `exec` + `get_result` 24,000-char pagination reassembly, and desktop side-by-side PNG comparison (`compare_screens`).
10
11
 
11
12
  ---
12
13
 
@@ -59,7 +60,16 @@ claude mcp add --transport http luaward https://luaward.com/mcp --header "Author
59
60
  - `mode="camera"` / `action="camera_rotate"` (Cursor Locked / First-Person / Shift-Lock): pure relative `MOUSEEVENTF_MOVE` (`dx`, `dy`) for Windows Raw Input (`WM_INPUT`).
60
61
  - Also supports `drag_and_drop` and `scroll`.
61
62
  - **`desktop_keyboard`**: Win32 `SendInput` with hardware `KEYEVENTF_SCANCODE` (`press`, `key_down`, `key_up`, `hotkey`) for DirectInput/Roblox keybinds and `KEYEVENTF_UNICODE` (`type`) for arbitrary text.
62
- - **`os_click`**: Hybrid tool that resolves `#n` (from `gui_snapshot`) or a `GuiObject` path inside Roblox, combines `AbsolutePosition` + `GuiService:GetGuiInset()` + Win32 `GetClientRect`/`ClientToScreen` scaling, and sends a real OS Win32 click at the exact center.
63
+ - **`os_click`**: Hybrid tool that resolves `#n` (from `gui_snapshot`) or a `GuiObject` path inside Roblox, combines `AbsolutePosition` + `GuiService:GetGuiInset()` + Win32 `GetClientRect`/`ClientToScreen` scaling, forces Roblox to foreground with `AttachThreadInput` + occlusion verification (`WindowFromPoint`) before clicking, and verifies `GetMouseLocation()` + `gui_snapshot(diff_from="last")` when `verify=true`.
64
+
65
+ ### Roblox Studio Bridge & Visual Comparison (v0.2.7)
66
+ - **`studio_mirror_remotes`**: BFS + network-first scan of live `RemoteEvent`, `RemoteFunction`, and `UnreliableRemoteEvent` instances (`kind="network"` by default; explicit `"bindable"` / `"all"` supported; deprioritizes bulky `Model`/`Assets` folders) and reconstructs the folder/remote tree in Roblox Studio (`Edit`, `Client`, or `Server` DataModel). Automatically reassembles multi-page Cloud `exec` + `get_result` outputs.
67
+ - **`studio_mirror_gui`**: Captures live `PlayerGui` (or explicit `target` path / `#n` handle, plus optional `CoreGui`) hierarchy with properties (`Position`, `Size`, `AnchorPoint`, `Visible`, `Text`, `UICorner`, colors) across full `get_result` pages and rebuilds the GUI tree inside Studio `StarterGui`.
68
+ - **`studio_diff`**: Compares live game instances against Roblox Studio (`scope`: `all`, `scripts`, `remotes`, `gui`) with full Cloud pagination reassembly and strict error reporting.
69
+ - **`studio_to_live`**: Reads a `Script`, `LocalScript`, or `ModuleScript` from Roblox Studio (`studio_path` or current `Selection`) and runs it in the live game via `run_and_collect` (mapping `wait_seconds` to `settle_ms` and forwarding `timeout_ms`) or `exec`.
70
+ - **`studio_publish`**: Reads a script from Roblox Studio (`studio_path` or `Selection`) and creates (`create_script`) or deploys/protects (`deploy_script`) it on Luaward Cloud.
71
+ - **`live_scripts_to_studio`**: Decompiles `LocalScript`/`ModuleScript` sources from the live connected game across paginated Cloud `exec` outputs and imports them (with `.Disabled = true` by default) into Studio `ServerStorage.<name>` or any dotted Studio service path such as `ReplicatedStorage.Debug.LiveScripts`.
72
+ - **`compare_screens`**: Captures screenshots of two windows (`target_a="roblox"` vs `target_b="studio"` by default, or `base64_a`/`base64_b`), computes overall and 4x4 grid pixel similarity metrics, and returns both PNG images side by side by default (`include_images=true`).
63
73
 
64
74
  ---
65
75
 
@@ -75,7 +85,7 @@ claude mcp add --transport http luaward https://luaward.com/mcp --header "Author
75
85
  | `--no-auto-inject` / `LUAWARD_AUTO_INJECT=0` | Disable zero-touch Potassium auto-inject | Enabled (`true`) |
76
86
  | `POTASSIUM_AUTOEXEC_DIR` | Custom Potassium `autoexec` / `AUTO EXECUTE` folder for `install_autoexec` | Auto-detected |
77
87
  | `ROBLOX_PLAYER_PATH` / `POTASSIUM_PATH` | Optional explicit paths to `RobloxPlayerBeta.exe` or `Potassium.exe` | Auto-detected |
78
- | `--version`, `-v` | Print package version (`@luaward/mcp/0.2.2`) | - |
88
+ | `--version`, `-v` | Print package version (`@luaward/mcp/0.2.7`) | - |
79
89
  | `--help`, `-h` | Show usage help | - |
80
90
 
81
91
  ---