@weppy/roblox-mcp 2.2.2 → 2.3.1

package/install.sh

@@ -5,10 +5,9 @@
 # Usage:
 #   curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.sh | bash
 #
-# Interactive 3 steps:
-#   [1/3] MCP server install (npm)
-#   [2/3] Roblox Studio Plugin install (.rbxm)
-#   [3/3] Register MCP with AI apps (user selection)
+# Interactive 2 steps:
+#   [1/2] Setup — install Roblox Studio Plugin via npx
+#   [2/2] Register MCP with AI apps (user selection)
 #
 
 set -euo pipefail
@@ -74,6 +73,10 @@ trap 'handle_install_error "${LINENO}" "$BASH_COMMAND"' ERR
 confirm() {
   local prompt="$1"
   local reply
+  if [ "${CI:-}" = "true" ]; then
+    printf "%s (Y/n): Y\n" "$prompt"
+    return 0
+  fi
   printf "%s (Y/n): " "$prompt"
   read -r reply </dev/tty
   reply="${reply:-Y}"
@@ -117,7 +120,7 @@ try {
 ' >/dev/null 2>&1
 }
 
-# Add MCP server to Antigravity config (flat top-level keys, no mcpServers wrapper)
+# Antigravity 설정에 canonical mcpServers 래퍼로 MCP 서버를 추가하고 legacy flat key를 정리
 add_antigravity_mcp_config() {
   local config_path="$1"
   local parent_dir
@@ -128,7 +131,20 @@ const fs = require("fs");
 const configPath = process.env.MCP_CONFIG_PATH;
 let config = {};
 try { config = JSON.parse(fs.readFileSync(configPath, "utf8")); } catch {}
-config["weppy-roblox-mcp"] = { command: "npx", args: ["-y", "@weppy/roblox-mcp"] };
+if (!config || typeof config !== "object" || Array.isArray(config)) {
+  config = {};
+}
+const mcpServers = config.mcpServers;
+if (mcpServers !== undefined && (typeof mcpServers !== "object" || mcpServers === null || Array.isArray(mcpServers))) {
+  throw new Error("Antigravity mcpServers must be an object");
+}
+const next = { ...config };
+delete next["weppy-roblox-mcp"];
+next.mcpServers = {
+  ...(mcpServers || {}),
+  "weppy-roblox-mcp": { command: "npx", args: ["-y", "@weppy/roblox-mcp"] }
+};
+config = next;
 fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
 '
 }
@@ -141,9 +157,24 @@ is_antigravity_mcp_configured() {
   MCP_CONFIG_PATH="$config_path" node -e '
 const fs = require("fs");
 const configPath = process.env.MCP_CONFIG_PATH;
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function hasExpectedCommandShape(value) {
+  return (
+    isJsonObject(value) &&
+    value.command === "npx" &&
+    Array.isArray(value.args) &&
+    value.args.length === 2 &&
+    value.args[0] === "-y" &&
+    value.args[1] === "@weppy/roblox-mcp"
+  );
+}
 try {
   const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
-  process.exit(config?.["weppy-roblox-mcp"] ? 0 : 1);
+  const canonical = config?.mcpServers?.["weppy-roblox-mcp"];
+  const hasLegacyFlatKey = Object.prototype.hasOwnProperty.call(config, "weppy-roblox-mcp");
+  process.exit(hasExpectedCommandShape(canonical) && !hasLegacyFlatKey ? 0 : 1);
 } catch {
   process.exit(1);
 }
@@ -154,7 +185,414 @@ is_codex_config_configured() {
   local config_path="$1"
 
   [ -f "$config_path" ] || return 1
-  grep -Eq '^[[:space:]]*\[mcp_servers\.weppy-roblox-mcp\][[:space:]]*$' "$config_path"
+  MCP_CODEX_CONFIG_PATH="$config_path" node <<'NODE' >/dev/null 2>&1
+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"];
+const headerPattern = new RegExp(
+  "^\\s*\\[\\s*mcp_servers\\." + serverName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "\\s*\\]\\s*(?:#.*)?$",
+);
+
+function stripCommentOutsideStrings(line) {
+  let inSingle = false;
+  let inDouble = false;
+  let escaped = false;
+
+  for (let index = 0; index < line.length; index += 1) {
+    const char = line[index];
+
+    if (char === '"' && !inSingle && !escaped) {
+      inDouble = !inDouble;
+    } else if (char === "'" && !inDouble && !escaped) {
+      inSingle = !inSingle;
+    } else if (char === "#" && !inSingle && !inDouble) {
+      return line.slice(0, index).trimEnd();
+    }
+
+    escaped = char === "\\" && !escaped;
+    if (char !== "\\") {
+      escaped = false;
+    }
+  }
+
+  return line.trimEnd();
+}
+
+function countTripleQuoteToggles(line, quote) {
+  let count = 0;
+  let inSingle = false;
+  let inDouble = false;
+  let escaped = false;
+
+  for (let index = 0; index < line.length; index += 1) {
+    const char = line[index] ?? "";
+    const nextThree = line.slice(index, index + 3);
+    const isOutsideStrings = !inSingle && !inDouble;
+
+    if (isOutsideStrings && nextThree === quote.repeat(3)) {
+      count += 1;
+      index += 2;
+      escaped = false;
+      continue;
+    }
+
+    if (char === '"' && !inSingle && !escaped) {
+      inDouble = !inDouble;
+    } else if (char === "'" && !inDouble && !escaped) {
+      inSingle = !inSingle;
+    } else if (char === "#" && !inSingle && !inDouble) {
+      break;
+    }
+
+    escaped = char === "\\" && !escaped;
+    if (char !== "\\") {
+      escaped = false;
+    }
+  }
+
+  return count;
+}
+
+function advanceTripleQuoteState(line, state) {
+  const next = { ...state };
+  const tripleDoubleCount = countTripleQuoteToggles(line, '"');
+  const tripleSingleCount = countTripleQuoteToggles(line, "'");
+
+  if (!next.inTripleSingle && tripleDoubleCount % 2 === 1) {
+    next.inTripleDouble = !next.inTripleDouble;
+  }
+
+  if (!next.inTripleDouble && tripleSingleCount % 2 === 1) {
+    next.inTripleSingle = !next.inTripleSingle;
+  }
+
+  return next;
+}
+
+function isTomlTableHeaderLine(line) {
+  const normalized = stripCommentOutsideStrings(line).trim();
+
+  if (normalized.length === 0) {
+    return false;
+  }
+
+  return /^\[\[.*\]\]$/.test(normalized) || /^\[.*\]$/.test(normalized);
+}
+
+function findAllCodexBlocks(source) {
+  const lines = source.split("\n");
+  const blocks = [];
+  let activeLines = null;
+  let state = {
+    inTripleDouble: false,
+    inTripleSingle: false,
+  };
+
+  for (const line of lines) {
+    const isHeaderCandidate = !state.inTripleDouble && !state.inTripleSingle && isTomlTableHeaderLine(line);
+    const isCodexHeader = isHeaderCandidate && headerPattern.test(line);
+
+    if (isCodexHeader) {
+      if (activeLines !== null) {
+        blocks.push(activeLines.join("\n").trim());
+      }
+      activeLines = [line];
+    } else if (activeLines !== null && isHeaderCandidate) {
+      blocks.push(activeLines.join("\n").trim());
+      activeLines = null;
+    } else if (activeLines !== null) {
+      activeLines.push(line);
+    }
+
+    state = advanceTripleQuoteState(line, state);
+  }
+
+  if (activeLines !== null) {
+    blocks.push(activeLines.join("\n").trim());
+  }
+
+  return blocks;
+}
+
+function parseStringAssignment(value, key) {
+  const match = new RegExp("^\\s*" + key + "\\s*=\\s*([\"'])([^\"']+)\\1\\s*$").exec(value);
+  return match ? match[2] : null;
+}
+
+function parseTomlStringArray(value) {
+  const match = /^\s*args\s*=\s*\[(.*)\]\s*$/ms.exec(value.trim());
+
+  if (match === null) {
+    return null;
+  }
+
+  const body = match[1] ?? "";
+  const values = [];
+  let cursor = 0;
+  let expectValue = true;
+
+  while (cursor < body.length) {
+    while (cursor < body.length && /\s/.test(body[cursor] ?? "")) {
+      cursor += 1;
+    }
+
+    if (cursor >= body.length) {
+      break;
+    }
+
+    if (!expectValue) {
+      if (body[cursor] !== ",") {
+        return null;
+      }
+      cursor += 1;
+      expectValue = true;
+      continue;
+    }
+
+    const quote = body[cursor];
+    if (quote !== '"' && quote !== "'") {
+      return null;
+    }
+
+    cursor += 1;
+    let token = "";
+    let escaped = false;
+
+    while (cursor < body.length) {
+      const char = body[cursor] ?? "";
+
+      if (char === quote && !escaped) {
+        cursor += 1;
+        values.push(token);
+        break;
+      }
+
+      token += char;
+      escaped = char === "\\" && !escaped;
+      if (char !== "\\") {
+        escaped = false;
+      }
+      cursor += 1;
+    }
+
+    if (cursor > body.length) {
+      return null;
+    }
+
+    expectValue = false;
+  }
+
+  const leftover = body.slice(cursor).trim();
+  if (leftover === ",") {
+    return values;
+  }
+
+  return leftover.length === 0 ? values : null;
+}
+
+function collectArrayLines(lines, startIndex) {
+  const collected = [stripCommentOutsideStrings(lines[startIndex] ?? "")];
+  let bracketDepth = 0;
+  let inSingle = false;
+  let inDouble = false;
+  let escaped = false;
+
+  for (let lineIndex = startIndex; lineIndex < lines.length; lineIndex += 1) {
+    const sanitized = stripCommentOutsideStrings(lines[lineIndex] ?? "");
+    if (lineIndex !== startIndex) {
+      collected.push(sanitized);
+    }
+
+    for (let index = 0; index < sanitized.length; index += 1) {
+      const char = sanitized[index] ?? "";
+
+      if (char === '"' && !inSingle && !escaped) {
+        inDouble = !inDouble;
+      } else if (char === "'" && !inDouble && !escaped) {
+        inSingle = !inSingle;
+      } else if (!inSingle && !inDouble) {
+        if (char === "[") {
+          bracketDepth += 1;
+        } else if (char === "]") {
+          bracketDepth -= 1;
+        }
+      }
+
+      escaped = char === "\\" && !escaped;
+      if (char !== "\\") {
+        escaped = false;
+      }
+    }
+
+    if (bracketDepth <= 0) {
+      return {
+        nextIndex: lineIndex,
+        text: collected.join("\n"),
+      };
+    }
+  }
+
+  return null;
+}
+
+function parseCodexBlock(blockContent) {
+  const lines = blockContent.split("\n");
+  let command = null;
+  let args = null;
+  let hasConflict = false;
+  let inTripleDouble = false;
+  let inTripleSingle = false;
+
+  for (let index = 1; index < lines.length; index += 1) {
+    const line = lines[index] ?? "";
+    const sanitized = stripCommentOutsideStrings(line);
+    const trimmed = sanitized.trim();
+
+    if (inTripleDouble) {
+      if (countTripleQuoteToggles(sanitized, '"') % 2 === 1) {
+        inTripleDouble = false;
+      }
+      continue;
+    }
+
+    if (inTripleSingle) {
+      if (countTripleQuoteToggles(sanitized, "'") % 2 === 1) {
+        inTripleSingle = false;
+      }
+      continue;
+    }
+
+    if (countTripleQuoteToggles(sanitized, '"') % 2 === 1) {
+      inTripleDouble = true;
+      continue;
+    }
+
+    if (countTripleQuoteToggles(sanitized, "'") % 2 === 1) {
+      inTripleSingle = true;
+      continue;
+    }
+
+    if (trimmed.length === 0) {
+      continue;
+    }
+
+    if (/^command\s*=/.test(trimmed)) {
+      const parsedCommand = parseStringAssignment(trimmed, "command");
+      if (command !== null || parsedCommand === null) {
+        hasConflict = true;
+      } else {
+        command = parsedCommand;
+      }
+      continue;
+    }
+
+    if (/^args\s*=/.test(trimmed)) {
+      const collected = collectArrayLines(lines, index);
+      const parsedArgs = collected === null ? null : parseTomlStringArray(collected.text);
+
+      if (args !== null || parsedArgs === null || collected === null) {
+        hasConflict = true;
+      } else {
+        args = parsedArgs;
+        index = collected.nextIndex;
+      }
+    }
+  }
+
+  return {
+    args,
+    command,
+    hasConflict,
+  };
+}
+
+function isStructurallySafe(source) {
+  let bracketDepth = 0;
+  let braceDepth = 0;
+  let inSingle = false;
+  let inDouble = false;
+  let escaped = false;
+  let tripleState = {
+    inTripleDouble: false,
+    inTripleSingle: false,
+  };
+
+  for (const line of source.split("\n")) {
+    tripleState = advanceTripleQuoteState(line, tripleState);
+
+    for (let index = 0; index < line.length; index += 1) {
+      const char = line[index] ?? "";
+
+      if (!inSingle && !inDouble && char === "#") {
+        break;
+      }
+
+      if (char === '"' && !inSingle && !escaped) {
+        inDouble = !inDouble;
+      } else if (char === "'" && !inDouble && !escaped) {
+        inSingle = !inSingle;
+      } else if (!inSingle && !inDouble) {
+        if (char === "[") {
+          bracketDepth += 1;
+        } else if (char === "]") {
+          bracketDepth -= 1;
+          if (bracketDepth < 0) {
+            return false;
+          }
+        } else if (char === "{") {
+          braceDepth += 1;
+        } else if (char === "}") {
+          braceDepth -= 1;
+          if (braceDepth < 0) {
+            return false;
+          }
+        }
+      }
+
+      escaped = char === "\\" && !escaped;
+      if (char !== "\\") {
+        escaped = false;
+      }
+    }
+  }
+
+  return (
+    !tripleState.inTripleDouble &&
+    !tripleState.inTripleSingle &&
+    bracketDepth === 0 &&
+    braceDepth === 0 &&
+    !inSingle &&
+    !inDouble
+  );
+}
+
+try {
+  const source = fs.readFileSync(configPath, "utf8");
+  if (!isStructurallySafe(source)) {
+    process.exit(1);
+  }
+
+  const blocks = findAllCodexBlocks(source);
+  if (blocks.length !== 1) {
+    process.exit(1);
+  }
+
+  const parsed = parseCodexBlock(blocks[0]);
+  const isConfigured =
+    !parsed.hasConflict &&
+    parsed.command === expectedCommand &&
+    Array.isArray(parsed.args) &&
+    parsed.args.length === expectedArgs.length &&
+    parsed.args.every((entry, index) => entry === expectedArgs[index]);
+
+  process.exit(isConfigured ? 0 : 1);
+} catch {
+  process.exit(1);
+}
+NODE
 }
 
 resolve_optional_cli_command() {
@@ -175,16 +613,6 @@ resolve_optional_cli_command() {
   return 1
 }
 
-is_lfs_pointer() {
-  local file_path="$1"
-
-  if [ ! -f "$file_path" ]; then
-    return 1
-  fi
-
-  grep -q "git-lfs.github.com/spec/v1" "$file_path"
-}
-
 # ── Header ──
 # shellcheck disable=SC2059
 printf "\n${BOLD}WROX Installer${NC}\n"
@@ -208,67 +636,24 @@ fi
 success "Node.js $(node -v) detected"
 
 # ═══════════════════════════════════
-# [1/3] MCP server install
+# [1/2] Setup — Roblox Studio Plugin
 # ═══════════════════════════════════
-step "1/3" "Install @weppy/roblox-mcp via npm"
+step "1/2" "Setup Roblox Studio Plugin"
 
-if confirm "  Run npm install -g @weppy/roblox-mcp?"; then
-  if npm install -g @weppy/roblox-mcp; then
-    success "Installed @weppy/roblox-mcp"
+if confirm "  Run npx -y @weppy/roblox-mcp --setup?"; then
+  if npx -y @weppy/roblox-mcp --setup; then
+    success "Setup complete"
   else
-    fail "npm install failed"
-    exit 1
+    warn "Setup encountered a warning (non-blocking)"
   fi
 else
-  warn "MCP server install skipped"
+  warn "Setup skipped"
 fi
 
 # ═══════════════════════════════════
-# [2/3] Roblox Studio Plugin install
+# [2/2] Register MCP with AI apps
 # ═══════════════════════════════════
-step "2/3" "Install Roblox Studio Plugin"
-
-PLUGINS_DIR="$HOME/Documents/Roblox/Plugins"
-PLUGIN_NAME="WeppyRobloxMCP.rbxm"
-
-# Search for .rbxm in npm global prefix
-NPM_PREFIX=$(npm prefix -g 2>/dev/null)
-BUNDLED_PLUGIN=""
-
-# Search for .rbxm in npm global path
-for search_dir in \
-  "${NPM_PREFIX}/lib/node_modules/@weppy/roblox-mcp/plugins/weppy-roblox-mcp/roblox-plugin" \
-  "${NPM_PREFIX}/lib/node_modules/@weppy/roblox-mcp/roblox-plugin"; do
-  if [ -f "${search_dir}/${PLUGIN_NAME}" ]; then
-    BUNDLED_PLUGIN="${search_dir}/${PLUGIN_NAME}"
-    break
-  fi
-done
-
-if [ -n "$BUNDLED_PLUGIN" ]; then
-  if is_lfs_pointer "$BUNDLED_PLUGIN"; then
-    fail "Bundled plugin payload is invalid (Git LFS pointer detected)"
-    info "Install the plugin from the GitHub release ZIP instead"
-    exit 1
-  fi
-
-  printf "  → %s/%s\n" "$PLUGINS_DIR" "$PLUGIN_NAME"
-  if confirm "  Copy plugin to Roblox Plugins folder?"; then
-    mkdir -p "$PLUGINS_DIR"
-    cp "$BUNDLED_PLUGIN" "$PLUGINS_DIR/$PLUGIN_NAME"
-    success "Plugin installed → $PLUGINS_DIR/$PLUGIN_NAME"
-  else
-    warn "Plugin install skipped"
-  fi
-else
-  warn "Bundled plugin file not found"
-  info "Will be installed automatically on first MCP server run"
-fi
-
-# ═══════════════════════════════════
-# [3/3] Register MCP with AI apps
-# ═══════════════════════════════════
-step "3/3" "Register MCP with AI apps"
+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'
@@ -376,7 +761,12 @@ else
   # shellcheck disable=SC2059
   printf "\n  Select apps to register ${DIM}(comma-separated, 'a' for all, 'n' to skip)${NC}\n"
   printf "  → "
-  read -r selection </dev/tty
+  if [ "${CI:-}" = "true" ]; then
+    selection="a"
+    printf "a\n"
+  else
+    read -r selection </dev/tty
+  fi
   selection="${selection:-n}"
 
   # Parse selection

package/llms-full.txt

@@ -21,9 +21,21 @@ Roblox Studio Plugin ← Executes commands inside Studio
 
 When an AI app says "Create a blue part", the MCP server converts this request, and the Roblox Studio plugin actually creates the part.
 
-## One-Line Install (Recommended)
+## Web Installer (Recommended)
 
-Installs the MCP server, Roblox Studio plugin, and registers with your AI apps in one step:
+Open the installer page in Chrome, Edge, or Arc for one-click setup:
+
+https://hope1026.github.io/weppy-roblox-mcp/installer/
+
+It writes the supported AI app config for `npx -y @weppy/roblox-mcp` first.
+
+After you reopen the AI app, the first MCP run fetches the package through `npx` and auto-installs the Roblox Studio plugin.
+
+For Safari or Firefox, use the installer page as a guide or continue with the manual install below.
+
+## One-Line Install (Fallback)
+
+Advanced users can install everything in one command:
 
 ```bash
 # macOS / Linux

package/llms.txt

@@ -21,7 +21,11 @@ terrain, and more — inside a live Studio session.
 
 ## Installation
 
-**One-line install** (installs MCP server, Roblox Studio plugin, and registers with AI apps):
+**Web installer** (recommended one-click setup for Chrome, Edge, and Arc):
+
+https://hope1026.github.io/weppy-roblox-mcp/installer/
+
+**One-line install** (advanced fallback):
 
 ```bash
 # macOS / Linux
@@ -31,8 +35,10 @@ curl -fsSL https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/inst
 irm https://raw.githubusercontent.com/hope1026/weppy-roblox-mcp/main/install.ps1 | iex
 ```
 
-Or manually:
-1. Install Roblox Studio plugin (bridge between Studio and AI)
+Safari / Firefox users should follow the installer page guide or open the installation docs.
+
+Manual alternative:
+1. Install Roblox Studio plugin via the installation guide
 2. Register MCP server: `npx -y @weppy/roblox-mcp`
 
 ## Tiers
@@ -49,7 +55,7 @@ Or manually:
 - WROX Dashboard guide: https://github.com/hope1026/weppy-roblox-mcp/blob/main/docs/en/dashboard/overview.md
 - Troubleshooting: https://github.com/hope1026/weppy-roblox-mcp/blob/main/docs/troubleshooting.md
 - Compatibility: https://github.com/hope1026/weppy-roblox-mcp/blob/main/docs/compatibility.md
-- Pro upgrade: https://github.com/hope1026/weppy-roblox-mcp/blob/main/docs/en/pro-upgrade.md
+- Pro upgrade: https://weppy-web.pages.dev/en/plans
 
 ## Requirements
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "2.2.2",
+  "version": "2.3.1",
   "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.2.2",
+  "version": "2.3.1",
   "author": {
     "name": "hope1026"
   },