@weppy/roblox-mcp 2.6.3 → 2.7.0

package/.claude-plugin/marketplace.json

@@ -5,15 +5,15 @@
     "email": "hope841026@gmail.com"
   },
   "metadata": {
-    "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 23 tools, 162+ actions, bidirectional sync, automated playtest, and multi-place support",
-    "version": "2.6.3"
+    "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
+    "version": "2.7.0"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
-      "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 23 tools, 162+ actions, bidirectional sync, automated playtest, and multi-place support",
-      "version": "2.6.3",
+      "description": "Weppy Roblox MCP — MCP server that lets AI coding agents control a live Roblox Studio session with 21 tools, 140+ actions, bidirectional sync, automated playtest, and multi-place support",
+      "version": "2.7.0",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -3,7 +3,41 @@
 All notable changes to this project will be documented in this file.
 
 
+## [2.7.0] - 2026-05-05
 
+### Features
+
+- **UI Studio (Pro) — major upgrade** — `manage_ui` now supports a full design loop: open the dashboard's UI Studio page to see a per-request **History tab** (with before/after snapshots and design suggestions side-by-side), an **Analysis tab** with comparison modal, and a **Design Check** action that replaces the old `lint` action and reports issues against the quality bar. AI agents can also fetch a **partial design brief** scoped to the part of the tree they're editing, get **asset recommendations** (icons, ornaments, imagery) wired into the brief, and generate previews that respect a new isolated `UIVisibilityScope` so agent-driven UI work doesn't leak into your Studio session. Note: the old `manage_ui` action `lint` has been renamed to `design_check` — update any explicit calls. Stored UI Studio history from previous versions remains readable.
+
+- **UI Studio retention & storage controls** — A new **Storage** card on the dashboard lets you set a retention policy (max age + max size) for UI Studio request history. The retention runner cleans old runs in the background and supports dry-run preview before deletion. History entries can also be batch-selected and deleted from the Analysis tab.
+
+- **UI Studio dashboard redesign** — The UI Studio page is now split into **History** and **Analysis** tabs with a redesigned snapshot drawer (persistent toolbar, focus trap, drawer/dialog comparison view), tooltip help across UI Studio + Settings, a new connection guide for first-time users, and localized analysis detail strings. Thumbnails now use `object-fit: contain` so layouts aren't cropped.
+
+- **Reverse sync infers correct property types** — When you edit synced files locally and push them back to Studio, the server now resolves property types via class-aware metadata instead of guessing from value shape. This fixes cases where edits to enum, color, or vector properties on specific instance classes would silently land as the wrong type.
+
+- **GA4 telemetry: per-user attribution + better error diagnostics** — Telemetry events now include a stable `user_id` so the dashboard funnels reflect real users (with a documented DebugView verification path), and command failures emit structured error classification so you can tell config issues from runtime crashes from network failures at a glance. Telemetry is opt-in and unchanged for users who haven't enabled it.
+
+### Bug Fixes
+
+- **Installer: legacy `@weppy/roblox-mcp` entries auto-upgrade to `@latest`** — If you previously installed the MCP via an older one-liner that pinned a bare package name, the installer now rewrites that entry to `@latest` instead of leaving it on a stale version. Combined with `npx --ignore-existing` the next launch picks up the new release without manual config edits.
+
+- **Installer: Claude Code detection on Windows** — The installer mis-detected Claude Code on Windows and could fail with a confusing "already exists" error even on first install. Detection is now correct and an existing valid registration is treated as success.
+
+- **Dashboard tooltips no longer clipped** — Tooltips inside scrollable cards (Settings, UI Studio history) were clipped by `overflow:hidden` ancestors. They now render via a portal and display fully regardless of container.
+
+### Documentation
+
+- **UI Studio guide rewritten as a 3-layer English resource** — The design-system guide now reads top-down (intent → families → tokens), expands the palette/imagery/ornamentation/composition family menus, documents the quality-bar gate and slab-look anti-pattern, and clarifies multiline text encoding and transparent root defaults. Available via the `weppy://ui-studio/guide` MCP resource.
+
+- **Public docs: UI Studio added to README and llms files** — `deploy/publish/hope1026-roblox-mcp/README.md` and the `llms.txt` / `llms-full.txt` files now describe UI Studio capabilities so AI agents and human readers see it as a first-class feature.
+
+
+
+## [2.6.4] - 2026-04-22
+
+### Bug Fixes
+
+- **Fix MCP server crashing on startup** — The MCP server could crash immediately on startup, preventing any tools from loading. The server now starts cleanly without any config change.
 
 
 ## [2.6.3] - 2026-04-21

package/README.md

@@ -2,7 +2,7 @@
 
 > **WEPPY** is an MCP server that lets AI coding agents control a live Roblox Studio session - create and edit scripts, instances, terrain, lighting, assets, audio, and animations through natural language.
 
-**Action-based tool surface · Bidirectional sync · Automated playtest · Multi-place support**
+**Action-based tool surface · Bidirectional sync · Automated playtest · UI Studio · Multi-place support**
 
 **English** | [한국어](https://weppyai.com/ko) | [日本語](https://weppyai.com/ja) | [Español](https://weppyai.com/es) | [Português](https://weppyai.com/pt-br) | [Bahasa Indonesia](https://weppyai.com/id) | [Deutsch](https://weppyai.com/de)
 
@@ -87,7 +87,7 @@ AI works from a synchronized local mirror, so multi-file updates stay consistent
 - Basic: one-way sync (Studio -> Local)
 - Pro: bidirectional sync + per-type Direction/Apply Mode + history + multi-place
 
-![Sync workflow - Studio and local files synchronized in real time](docs/assets/screenshots/plugin/sync/sync-overview.png)
+![Sync workflow - Studio and local files synchronized in real time](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/plugin/sync/sync-overview.png)
 
 ### 3) Playtest: Let AI run and verify tests automatically
 
@@ -97,19 +97,29 @@ AI can control Roblox Studio playtests directly. It can start and stop Play (F5)
 - "Write a test that verifies the SpawnLocation is above the ground and run it."
 - "Validate that the script I just changed runs without errors in playtest."
 
-![WEPPY Playtest Dashboard - Test history and detailed report](docs/assets/screenshots/dashboard/dashboard_playtest.png)
+![WEPPY Playtest Dashboard - Test history and detailed report](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/dashboard/dashboard_playtest.png)
 
-### 4) WEPPY Dashboard: Monitor AI work in real time
+### 4) UI Studio: Build and inspect in-game UI
 
-The MCP server provides a web dashboard where you can check connection status, tool execution history, sync state, and game change logs in real time.
+UI Studio lets AI agents create in-game UI that matches your game's style, or analyze the UI you already have and suggest improvements.
+
+- Clarify the UI goal with guided questions about purpose, screen, target devices, and visual direction
+- Create or refine game-style menus, HUDs, buttons, labels, image panels, and other Roblox UI elements directly in Studio
+- Capture the result, compare before/after changes, and follow dashboard suggestions for layout, readability, touch targets, and safe areas
+
+![WEPPY UI Studio - Roblox Studio showing AI-generated in-game UI](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/dashboard/dashboard_ui_roblox_studio.png)
+
+### 5) WEPPY Dashboard: Monitor AI work in real time
+
+The MCP server provides a web dashboard where you can check connection status, tool execution history, sync state, UI Studio history, and game change logs in real time.
 
 - Server/Plugin/Agent connection status at a glance
 - Compare every change the AI made via Before & After in Changelog
-- Analyze workflow with tool execution history and statistics
+- Analyze workflow with tool execution history, UI Studio captures, and statistics
 
-![WEPPY Dashboard Overview - Server status, recent changes, and session summary](docs/assets/screenshots/dashboard/dashboard_overview.png)
+![WEPPY Dashboard Overview - Server status, recent changes, and session summary](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/dashboard/dashboard_overview.png)
 
-### 5) WEPPY Roblox Explorer: Browse Studio hierarchy in VSCode
+### 6) WEPPY Roblox Explorer: Browse Studio hierarchy in VSCode
 
 View the full instance tree of your Roblox Studio place directly inside VSCode. Navigate services, open synced scripts and property files, and track sync status - all without switching to Studio.
 WEPPY Roblox Explorer is a companion VSCode extension for sync data generated by WEPPY. Tree browsing works from synced files, and live sync state or direction indicators are enhanced when the local MCP server is running.
@@ -119,13 +129,14 @@ Install from [VS Code Marketplace](https://marketplace.visualstudio.com/items?it
 - Click to open synced scripts and property files
 - Multi-place support with sync status indicators
 
-![WEPPY Roblox Explorer - Studio instance tree displayed in VSCode sidebar](docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
+![WEPPY Roblox Explorer - Studio instance tree displayed in VSCode sidebar](https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/docs/assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
 
 ## Use Cases
 
 - **Rapid prototyping**: Describe a game mechanic in natural language and watch AI build it in Studio
 - **Bulk refactoring**: Rename a module interface and update every dependent script in one request
 - **Terrain & environment**: Generate procedural terrain, set lighting/atmosphere, place assets - all from a single prompt
+- **UI design**: Generate in-game UI, capture previews, and iterate on Design Check suggestions
 - **Multi-file consistency**: AI reads the full project via Sync and applies changes across related scripts together
 - **Asset integration**: Search the Creator Store, insert models, and configure properties without leaving your editor
 
@@ -161,7 +172,7 @@ Yes. Any MCP-compatible AI client works.
 Yes. AI can create instances, write scripts, generate terrain, set up lighting, insert assets, configure physics, and more - all inside a live Roblox Studio session. It goes beyond code generation to executable actions.
 
 ### What is the difference between Basic and Pro?
-Basic (Free) includes MCP tool execution and one-way sync (Studio -> Local). Pro adds bidirectional sync, bulk operations, terrain generation, spatial analysis, audio/animation control, and multi-place support. See the Pro upgrade page.
+Basic (Free) includes MCP tool execution and one-way sync (Studio -> Local). Pro adds bidirectional sync, UI Studio, bulk operations, terrain generation, spatial analysis, audio/animation control, and multi-place support. See the Pro upgrade page.
 
 ### How is Weppy different from other Roblox MCP servers?
 Weppy uses action-based dispatching instead of separate tools for each function. This reduces AI token consumption significantly. It also provides bidirectional project sync and multi-place support, which most alternatives lack.
@@ -171,7 +182,7 @@ The server runs on localhost only (127.0.0.1:3002). Forbidden paths (CoreGui, Co
 
 ## Pro Upgrade
 
-Bidirectional Sync, advanced build capabilities, and AI token efficiency - all in one upgrade.
+Bidirectional Sync, UI Studio, advanced build capabilities, and AI token efficiency - all in one upgrade.
 
 [Pro Upgrade Guide](https://weppyai.com/en/plans)
 

package/install.ps1

@@ -112,7 +112,18 @@ function Test-McpJsonConfigured($configPath) {
     }
 }
 
-# Antigravity 설정에 canonical mcpServers 래퍼로 MCP 서버를 추가하고 legacy flat key를 정리
+# Require an explicit `@<tag>` so the installer can upgrade legacy bare
+# entries (`@weppy/roblox-mcp`) — those reuse npx cache and trap users on
+# outdated versions. Tagged entries (`@latest`, `@2.6.4`, …) are preserved.
+function Test-WeppyPackageSpec($value) {
+    if ([string]::IsNullOrWhiteSpace($value)) {
+        return $false
+    }
+    return $value -match '^@weppy/roblox-mcp@.+$'
+}
+
+# Add the MCP server under the canonical `mcpServers` wrapper in the Antigravity
+# config and strip any legacy flat key left over from earlier versions.
 function Add-AntigravityMcpConfig($configPath) {
     $parentDir = Split-Path $configPath -Parent
     if (-not (Test-Path $parentDir)) { New-Item -ItemType Directory -Path $parentDir -Force | Out-Null }
@@ -134,7 +145,7 @@ const next = { ...config };
 delete next['weppy-roblox-mcp'];
 next.mcpServers = {
   ...(mcpServers || {}),
-  'weppy-roblox-mcp': { command: 'npx', args: ['-y', '@weppy/roblox-mcp'] }
+  'weppy-roblox-mcp': { command: 'npx', args: ['-y', '@weppy/roblox-mcp@latest'] }
 };
 config = next;
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
@@ -153,7 +164,8 @@ function Test-AntigravityMcpConfigured($configPath) {
         $config = Get-Content -Path $configPath -Raw | ConvertFrom-Json
         $hasLegacyFlatKey = $config.PSObject.Properties.Name -contains 'weppy-roblox-mcp'
         $server = $config.mcpServers.'weppy-roblox-mcp'
-        $hasCanonicalArgs = ($server.args -is [System.Array]) -and ($server.args.Count -eq 2) -and ($server.args[0] -eq '-y') -and ($server.args[1] -eq '@weppy/roblox-mcp')
+        # Accept args[1] as the weppy package regardless of whether a version tag is appended.
+        $hasCanonicalArgs = ($server.args -is [System.Array]) -and ($server.args.Count -eq 2) -and ($server.args[0] -eq '-y') -and (Test-WeppyPackageSpec $server.args[1])
         return ($server.command -eq 'npx') -and $hasCanonicalArgs -and (-not $hasLegacyFlatKey)
     }
     catch {
@@ -174,7 +186,8 @@ const fs = require('fs');
 const configPath = process.env.MCP_CODEX_CONFIG_PATH;
 const serverName = 'weppy-roblox-mcp';
 const expectedCommand = 'npx';
-const expectedArgs = ['-y', '@weppy/roblox-mcp'];
+// Require an explicit `@<tag>` so the installer can upgrade legacy bare entries.
+const packageSpecPattern = /^@weppy\/roblox-mcp@.+$/;
 const headerPattern = new RegExp(
   '^\\s*\\[\\s*mcp_servers\\.' + serverName.replace(/[.*+?^${}()|[\]\\\\]/g, '\\$&') + '\\s*\\]\\s*(?:#.*)?$'
 );
@@ -568,8 +581,10 @@ try {
     !parsed.hasConflict &&
     parsed.command === expectedCommand &&
     Array.isArray(parsed.args) &&
-    parsed.args.length === expectedArgs.length &&
-    parsed.args.every((entry, index) => entry === expectedArgs[index]);
+    parsed.args.length === 2 &&
+    parsed.args[0] === '-y' &&
+    typeof parsed.args[1] === 'string' &&
+    packageSpecPattern.test(parsed.args[1]);
 
   process.exit(isConfigured ? 0 : 1);
 } catch {
@@ -595,7 +610,7 @@ const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, 'utf8')); } catch {}
 if (!config.mcpServers) config.mcpServers = {};
-config.mcpServers['weppy-roblox-mcp'] = { command: 'npx', args: ['-y', '@weppy/roblox-mcp'] };
+config.mcpServers['weppy-roblox-mcp'] = { command: 'npx', args: ['-y', '@weppy/roblox-mcp@latest'] };
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
 "@
     } finally {
@@ -627,7 +642,7 @@ catch {
 # ═══════════════════════════════════
 Write-Step "1/2" "Setup Roblox Studio Plugin"
 
-if (Confirm-Action "  Run npx -y @weppy/roblox-mcp --setup?") {
+if (Confirm-Action "  Run npx -y @weppy/roblox-mcp@latest --setup?") {
     try {
         $npmCommandPath = Resolve-NpmCommand
         $npmDir = Split-Path $npmCommandPath -Parent
@@ -641,9 +656,11 @@ if (Confirm-Action "  Run npx -y @weppy/roblox-mcp --setup?") {
         try {
             New-Item -ItemType Directory -Path $setupWorkingDir -Force | Out-Null
             Set-Location $setupWorkingDir
-            # stdin을 빈 파이프로 격리: irm|iex 대화형 모드에서 stdio MCP 서버가
-            # pwsh의 터미널 stdin을 상속받아 hang되는 문제를 방지한다
-            $null | & $npxPath -y @weppy/roblox-mcp --setup
+            # Isolate stdin with an empty pipe so the stdio MCP server does not inherit
+            # the interactive pwsh terminal stdin (which would cause it to hang under irm|iex).
+            # The @latest tag forces npx to resolve from the registry instead of
+            # reusing an older version pinned in the npm cache.
+            $null | & $npxPath -y "@weppy/roblox-mcp@latest" --setup
             if ($LASTEXITCODE -ne 0) {
                 Write-Warn "Setup encountered a warning (non-blocking)"
             } else {
@@ -675,9 +692,30 @@ $notDetected = @()
 
 $claudeProjectConfig = Join-Path (Get-Location).Path '.mcp.json'
 $claudeGlobalConfig = Join-Path $env:USERPROFILE '.claude\mcp.json'
-$claudeCodeConfigured = (Test-McpJsonConfigured $claudeProjectConfig) -or (Test-McpJsonConfigured $claudeGlobalConfig)
 $claudeCodeCliCommand = Resolve-OptionalCliCommand 'claude'
 
+# `claude mcp add` stores entries under ~/.claude.json or in local/user scope,
+# so prefer `claude mcp list` as the source of truth when the CLI is available
+# (the JSON path checks remain as a fallback). The entry counts as configured
+# only when its args carry an explicit `@<tag>` — legacy bare entries fall
+# through and get re-registered with the canonical `@latest` form.
+function Test-ClaudeCliConfigured($cliCommand) {
+    if (-not $cliCommand) { return $false }
+    try {
+        $listOutput = & $cliCommand mcp list 2>$null
+        if ($LASTEXITCODE -ne 0) { return $false }
+        $line = $listOutput | Select-String -Pattern '^weppy-roblox-mcp:' | Select-Object -First 1
+        if (-not $line) { return $false }
+        return ($line.Line -match '@weppy/roblox-mcp@')
+    } catch {
+        return $false
+    }
+}
+
+$claudeCodeConfigured = (Test-ClaudeCliConfigured $claudeCodeCliCommand) `
+    -or (Test-McpJsonConfigured $claudeProjectConfig) `
+    -or (Test-McpJsonConfigured $claudeGlobalConfig)
+
 if ($claudeCodeConfigured) {
     $detectedNames += 'Claude Code (configured)'
     $detectedTypes += 'claude-code'
@@ -762,7 +800,7 @@ else {
 
 if ($detectedNames.Count -eq 0) {
     Write-Warn "No AI apps detected"
-    Write-Info "Register MCP server manually: npx -y @weppy/roblox-mcp"
+    Write-Info "Register MCP server manually: npx -y @weppy/roblox-mcp@latest"
 }
 else {
     Write-Host ""
@@ -816,12 +854,40 @@ else {
                         Write-Ok "Already configured: $appName"
                     }
                     elseif ($claudeCodeCliCommand) {
-                        & $claudeCodeCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp"
-                        if ($LASTEXITCODE -ne 0) {
-                            # CLI 실패 시 (Windows에서 -- 파싱 문제 등) JSON config에 직접 쓰기로 폴백
-                            Add-McpToConfig $claudeGlobalConfig
+                        $claudeStderrFile = Join-Path ([System.IO.Path]::GetTempPath()) ("weppy-claude-{0}.err" -f ([System.Guid]::NewGuid().ToString("N")))
+                        try {
+                            # Best-effort remove any legacy bare entry so the subsequent add can
+                            # install the canonical `@latest` form.
+                            try { & $claudeCodeCliCommand mcp remove weppy-roblox-mcp *> $null } catch {}
+                            & $claudeCodeCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest" 2> $claudeStderrFile
+                            $claudeExit = $LASTEXITCODE
+                            if ($claudeExit -eq 0) {
+                                Write-Ok "Registered: $appName"
+                            }
+                            else {
+                                $stderrContent = if (Test-Path $claudeStderrFile) { Get-Content $claudeStderrFile -Raw } else { '' }
+                                if ($stderrContent -match '(?i)already exists') {
+                                    # Already registered in another scope — not a failure
+                                    Write-Ok "Already configured: $appName"
+                                }
+                                else {
+                                    Write-Fail "Failed: $appName (exit=$claudeExit)"
+                                    Write-Host "    CLI: $claudeCodeCliCommand" -ForegroundColor DarkGray
+                                    if ($stderrContent) {
+                                        Write-Host "    stderr:" -ForegroundColor DarkGray
+                                        $stderrContent.TrimEnd("`r","`n").Split("`n") | ForEach-Object {
+                                            Write-Host "      $($_.TrimEnd())" -ForegroundColor DarkGray
+                                        }
+                                    }
+                                    # Fall back to writing the JSON config directly when the CLI fails for other reasons
+                                    Add-McpToConfig $claudeGlobalConfig
+                                    Write-Ok "Registered via fallback JSON: $appName"
+                                }
+                            }
+                        }
+                        finally {
+                            Remove-Item $claudeStderrFile -ErrorAction SilentlyContinue
                         }
-                        Write-Ok "Registered: $appName"
                     }
                     else {
                         Write-Fail "Failed: $appName (CLI/config unavailable)"
@@ -842,7 +908,7 @@ else {
                     }
                     elseif ($codexCliCommand) {
                         try { & $codexCliCommand mcp remove weppy-roblox-mcp *> $null } catch {}
-                        & $codexCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp"
+                        & $codexCliCommand mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest"
                         if ($LASTEXITCODE -ne 0) {
                             throw 'codex mcp add failed'
                         }

package/install.sh

@@ -98,7 +98,7 @@ const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, "utf8")); } catch {}
 if (!config.mcpServers) config.mcpServers = {};
-config.mcpServers["weppy-roblox-mcp"] = { command: "npx", args: ["-y", "@weppy/roblox-mcp"] };
+config.mcpServers["weppy-roblox-mcp"] = { command: "npx", args: ["-y", "@weppy/roblox-mcp@latest"] };
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 '
 }
@@ -120,7 +120,8 @@ try {
 ' >/dev/null 2>&1
 }
 
-# Antigravity 설정에 canonical mcpServers 래퍼로 MCP 서버를 추가하고 legacy flat key를 정리
+# Add the MCP server under the canonical `mcpServers` wrapper in the Antigravity
+# config and strip any legacy flat key left over from earlier versions.
 add_antigravity_mcp_config() {
   local config_path="$1"
   local parent_dir
@@ -142,7 +143,7 @@ const next = { ...config };
 delete next["weppy-roblox-mcp"];
 next.mcpServers = {
   ...(mcpServers || {}),
-  "weppy-roblox-mcp": { command: "npx", args: ["-y", "@weppy/roblox-mcp"] }
+  "weppy-roblox-mcp": { command: "npx", args: ["-y", "@weppy/roblox-mcp@latest"] }
 };
 config = next;
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
@@ -161,13 +162,17 @@ function isJsonObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function hasExpectedCommandShape(value) {
+  // Require an explicit `@<tag>` so the installer can upgrade legacy bare
+  // entries (`@weppy/roblox-mcp`) — those reuse npx cache and trap users on
+  // outdated versions. Tagged entries (`@latest`, `@2.6.4`, …) are preserved.
   return (
     isJsonObject(value) &&
     value.command === "npx" &&
     Array.isArray(value.args) &&
     value.args.length === 2 &&
     value.args[0] === "-y" &&
-    value.args[1] === "@weppy/roblox-mcp"
+    typeof value.args[1] === "string" &&
+    /^@weppy\/roblox-mcp@.+$/.test(value.args[1])
   );
 }
 try {
@@ -191,7 +196,8 @@ const fs = require("fs");
 const configPath = process.env.MCP_CODEX_CONFIG_PATH;
 const serverName = "weppy-roblox-mcp";
 const expectedCommand = "npx";
-const expectedArgs = ["-y", "@weppy/roblox-mcp"];
+// Require an explicit `@<tag>` so the installer can upgrade legacy bare entries.
+const packageSpecPattern = /^@weppy\/roblox-mcp@.+$/;
 const headerPattern = new RegExp(
   "^\\s*\\[\\s*mcp_servers\\." + serverName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\s*\\]\\s*(?:#.*)?$",
 );
@@ -585,8 +591,10 @@ try {
     !parsed.hasConflict &&
     parsed.command === expectedCommand &&
     Array.isArray(parsed.args) &&
-    parsed.args.length === expectedArgs.length &&
-    parsed.args.every((entry, index) => entry === expectedArgs[index]);
+    parsed.args.length === 2 &&
+    parsed.args[0] === "-y" &&
+    typeof parsed.args[1] === "string" &&
+    packageSpecPattern.test(parsed.args[1]);
 
   process.exit(isConfigured ? 0 : 1);
 } catch {
@@ -640,7 +648,7 @@ success "Node.js $(node -v) detected"
 # ═══════════════════════════════════
 step "1/2" "Setup Roblox Studio Plugin"
 
-if confirm "  Run npx -y @weppy/roblox-mcp --setup?"; then
+if confirm "  Run npx -y @weppy/roblox-mcp@latest --setup?"; then
   setup_tmp_dir=""
   if setup_tmp_dir=$(mktemp -d "${TMPDIR:-/tmp}/weppy-setup-XXXXXX" 2>/dev/null); then
     :
@@ -649,9 +657,11 @@ if confirm "  Run npx -y @weppy/roblox-mcp --setup?"; then
   fi
 
   if [ -n "${setup_tmp_dir:-}" ] && [ -d "$setup_tmp_dir" ]; then
-    # stdin을 /dev/null로 격리: curl|bash 파이프 모드에서 stdio MCP 서버가
-    # bash의 남은 스크립트 바이트를 소비해버리는 문제를 방지한다
-    if (cd "$setup_tmp_dir" && npx -y @weppy/roblox-mcp --setup </dev/null); then
+    # Isolate stdin with /dev/null so the stdio MCP server does not swallow the
+    # remaining bytes of this script when installed via `curl | bash`.
+    # The @latest tag forces npx to resolve from the registry instead of
+    # reusing an older version pinned in the npm cache.
+    if (cd "$setup_tmp_dir" && npx -y "@weppy/roblox-mcp@latest" --setup </dev/null); then
       success "Setup complete"
     else
       warn "Setup encountered a warning (non-blocking)"
@@ -671,7 +681,7 @@ fi
 step "2/2" "Register MCP with AI apps"
 printf "  Automatic registration: Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity\n"
 
-MCP_COMMAND='npx -y @weppy/roblox-mcp'
+MCP_COMMAND='npx -y @weppy/roblox-mcp@latest'
 
 # AI app detection
 declare -a DETECTED_NAMES=()
@@ -679,11 +689,25 @@ declare -a DETECTED_TYPES=()
 declare -a NOT_DETECTED=()
 
 # Claude Code
+# `claude mcp add` stores entries under ~/.claude.json or in local/user scope,
+# so prefer `claude mcp list` as the source of truth when the CLI is available
+# (the JSON path checks remain as a fallback).
 CLAUDE_PROJECT_MCP_CONFIG="$PWD/.mcp.json"
 CLAUDE_GLOBAL_MCP_CONFIG="$HOME/.claude/mcp.json"
 CLAUDE_CLI_COMMAND="$(resolve_optional_cli_command claude 2>/dev/null || true)"
 
-if is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
+is_claude_cli_configured() {
+  [ -n "$CLAUDE_CLI_COMMAND" ] || return 1
+  # The entry counts as configured only when its args carry an explicit `@tag`
+  # (e.g. `@latest`). Legacy bare entries fall through and get re-registered.
+  "$CLAUDE_CLI_COMMAND" mcp list 2>/dev/null \
+    | grep "^weppy-roblox-mcp:" \
+    | grep -q "@weppy/roblox-mcp@"
+}
+
+if is_claude_cli_configured \
+   || is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" \
+   || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
   DETECTED_NAMES+=("Claude Code (configured)")
   DETECTED_TYPES+=("claude-code")
 elif [ -n "$CLAUDE_CLI_COMMAND" ]; then
@@ -816,12 +840,34 @@ else
 
     case "$app_type" in
       claude-code)
-        if is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
+        if is_claude_cli_configured \
+           || is_json_mcp_configured "$CLAUDE_PROJECT_MCP_CONFIG" \
+           || is_json_mcp_configured "$CLAUDE_GLOBAL_MCP_CONFIG"; then
           success "Already configured: $app_name"
-        elif [ -n "$CLAUDE_CLI_COMMAND" ] && "$CLAUDE_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp 2>/dev/null; then
-          success "Registered: $app_name"
+        elif [ -n "$CLAUDE_CLI_COMMAND" ]; then
+          claude_stderr_file=$(mktemp "${TMPDIR:-/tmp}/weppy-claude-XXXXXX.err" 2>/dev/null || echo "${HOME}/weppy-claude.err")
+          # Best-effort remove any legacy bare entry so the subsequent add can
+          # install the canonical `@latest` form. Ignore errors when nothing
+          # exists.
+          "$CLAUDE_CLI_COMMAND" mcp remove weppy-roblox-mcp >/dev/null 2>&1 || true
+          # Capture the CLI exit code immediately so it isn't overwritten by the
+          # subsequent grep check (which would otherwise leak its own exit code).
+          claude_exit_code=0
+          "$CLAUDE_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest" 2>"$claude_stderr_file" || claude_exit_code=$?
+          if [ "$claude_exit_code" -eq 0 ]; then
+            success "Registered: $app_name"
+          elif grep -qi "already exists" "$claude_stderr_file"; then
+            # Already registered in another scope — not a failure
+            success "Already configured: $app_name"
+          else
+            fail "Failed: $app_name (exit=$claude_exit_code)"
+            printf "    CLI: %s\n" "$CLAUDE_CLI_COMMAND"
+            printf "    stderr:\n"
+            sed 's/^/      /' "$claude_stderr_file" || true
+          fi
+          rm -f "$claude_stderr_file"
         else
-          fail "Failed: $app_name"
+          fail "Failed: $app_name (claude CLI not found)"
         fi
         ;;
       claude-desktop)
@@ -846,7 +892,7 @@ else
         fi
         if is_codex_config_configured "$CODEX_CONFIG"; then
           :
-        elif [ -n "$CODEX_CLI_COMMAND" ] && "$CODEX_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y @weppy/roblox-mcp 2>/dev/null; then
+        elif [ -n "$CODEX_CLI_COMMAND" ] && "$CODEX_CLI_COMMAND" mcp add weppy-roblox-mcp -- npx -y "@weppy/roblox-mcp@latest" 2>/dev/null; then
           success "Registered: $app_name"
         elif is_codex_config_configured "$CODEX_CONFIG"; then
           success "Already configured: $app_name"

package/llms-full.txt

@@ -1,6 +1,6 @@
 # WEPPY — Canonical Web Docs
 
-> WEPPY is an MCP server that lets AI coding agents control a live Roblox Studio session and interact with scripts, instances, terrain, lighting, assets, audio, and animations.
+> WEPPY is an MCP server that lets AI coding agents control a live Roblox Studio session and interact with scripts, instances, terrain, lighting, assets, audio, animations, and UI Studio workflows.
 
 This package intentionally does not ship a standalone full documentation surface.
 
@@ -11,4 +11,3 @@ Canonical documentation lives on the web:
 - Pro plans: https://weppyai.com/en/plans
 
 For app-specific setup, open the web install page and choose the relevant AI client guide.
-

package/llms.txt

@@ -2,7 +2,7 @@
 
 > WEPPY is an MCP server that lets AI coding agents (Claude, Codex,
 > Cursor, Gemini) control a live Roblox Studio session — create and edit scripts,
-> instances, terrain, lighting, assets, audio, and animations via natural language.
+> instances, terrain, lighting, assets, audio, animations, and UI Studio workflows via natural language.
 
 ## What it does
 
@@ -14,6 +14,7 @@ terrain, and more — inside a live Studio session.
 - Action-based MCP tools covering the full Roblox Studio API surface
 - Bidirectional project sync between Roblox Studio and local files (Pro)
 - Automated playtest: AI starts/stops Play/Run, injects test scripts, collects logs
+- UI Studio: AI creates in-game UI that matches your game's style or analyzes existing UI and suggests improvements
 - Web dashboard: monitor AI actions, tool history, sync state, and changelog in real time at `http://localhost:3002`
 - Multi-place support (up to 3 places simultaneously)
 - Roblox Explorer VSCode extension for browsing Studio hierarchy
@@ -40,7 +41,7 @@ Safari / Firefox users should open the web install page and follow the browser-s
 ## Tiers
 
 - Basic (Free): MCP tool execution + one-way Studio -> Local sync
-- Pro: Bidirectional sync, bulk actions, terrain generation, spatial analysis, multi-place support, advanced tools
+- Pro: Bidirectional sync, UI Studio, bulk actions, terrain generation, spatial analysis, multi-place support, advanced tools
 
 ## Detailed docs
 
@@ -56,7 +57,7 @@ Safari / Firefox users should open the web install page and follow the browser-s
 ## Optional
 
 - Roblox Explorer VSCode extension (browse synced instance tree)
-- Pro subscription for bidirectional sync and advanced tools
+- Pro subscription for bidirectional sync, UI Studio, and advanced tools
 
 ## Links
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "2.6.3",
+  "version": "2.7.0",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-  "version": "2.6.3",
+  "version": "2.7.0",
   "author": {
     "name": "hope1026"
   },