@weppy/roblox-mcp 2.2.2 → 2.3.0

package/docs/ko/README.md

@@ -18,8 +18,6 @@ Claude, Codex, Gemini 같은 AI 코딩 에이전트는 강력하지만 — Roblo
 
 ## 빠른 설치
 
-**원라인 설치** — MCP 서버, Roblox Studio 플러그인, AI 앱 등록을 한 번에 진행합니다:
-
 **macOS / Linux**
 
 ```bash
@@ -32,15 +30,15 @@ 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
 ```
 
-Roblox Studio를 재시작하면 완료입니다!
+AI 앱을 다시 열고 Roblox Studio를 재시작하세요.
 
 자동 MCP 등록은 **Claude Code, Claude Desktop, Cursor, Codex CLI/App, Gemini CLI, Antigravity**를 지원합니다.
 
-Windows에서 PowerShell 실행이 차단되면 아래 수동 설치로 진행하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`도 사용할 수 있습니다.
+Windows에서 PowerShell 실행이 차단되면 아래 설치 가이드를 사용하세요. ZIP 패키지를 사용하는 경우 `setup-plugin.bat`, `setup-mcp.bat`도 사용할 수 있습니다.
 
 ### 수동 설치
 
-원라인 설치가 동작하지 않거나 환경상 자동 설치를 사용할 수 없는 경우, 아래 수동 설치를 대안으로 진행하세요.
+원라인 설치가 동작하지 않거나 환경상 자동 설치를 사용할 수 없는 경우, 아래 설치 가이드를 대안으로 진행하세요.
 
 **1단계** — Roblox Studio 플러그인 설치 (Studio와 AI를 연결하는 다리):
 [플러그인 설치 가이드](installation/roblox-plugin.md)

package/docs/ko/installation/README.md

@@ -16,7 +16,7 @@ AI 앱이 "파란 파트를 만들어줘"라고 하면, MCP 서버가 이 요청
 
 ## 원라인 설치 (권장)
 
-MCP 서버, Roblox Studio 플러그인, AI 앱 등록을 한 번에 진행합니다:
+아래 명령어 한 줄로 MCP 서버와 플러그인을 한 번에 설치합니다:
 
 **macOS / Linux**
 
@@ -30,7 +30,7 @@ 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
 ```
 
-Roblox Studio를 재시작하면 완료입니다!
+AI 앱을 다시 열고 Roblox Studio를 재시작하세요.
 
 설치 중 오류가 발생하면 임시 로그 파일 경로를 출력하고, 대화형 실행에서는 종료 전에 콘솔을 유지해서 원인을 확인할 수 있습니다.
 

package/docs/pt-br/README.md

@@ -18,8 +18,6 @@ Sem necessidade de copiar e colar código. A IA trabalha e você confere os resu
 
 ## Instalacao rapida
 
-**Instalacao em um comando** — Instala o servidor MCP, o plugin do Roblox Studio e registra nos apps de IA em um único passo:
-
 **macOS / Linux**
 
 ```bash
@@ -40,7 +38,7 @@ Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação
 
 ### Instalacao manual
 
-Se a instalação em um comando não funcionar, ou se a instalação automática não puder ser usada no seu ambiente, use a instalação manual abaixo como alternativa.
+Se a instalacao em um comando nao funcionar, ou se a instalacao automatica nao puder ser usada no seu ambiente, use a instalacao manual abaixo como alternativa.
 
 **Passo 1** — Instale o plugin do Roblox Studio (ponte entre Studio e IA):
 [Guia de instalacao do plugin](installation/roblox-plugin.md)

package/docs/pt-br/installation/README.md

@@ -16,7 +16,7 @@ Quando o app de IA diz "cria uma parte azul", o servidor MCP converte o pedido e
 
 ## Instalação em um comando (Recomendado)
 
-Instala o servidor MCP, o plugin do Roblox Studio e registra nos apps de IA em um único passo:
+Instale tudo com um único comando:
 
 **macOS / Linux**
 
@@ -40,7 +40,7 @@ Se a execução do PowerShell estiver bloqueada no Windows, siga a instalação
 
 ## Instalação manual
 
-Este é o método alternativo para quando a instalação em um comando não funcionar, ou quando a instalação automática não puder ser usada no seu ambiente.
+Se a instalacao em um comando nao funcionar, ou quando a instalacao automatica nao puder ser usada no seu ambiente, use a instalacao manual abaixo como alternativa.
 
 ### Passo 1: Instalar plugin do Roblox Studio
 

package/install.ps1

@@ -139,7 +139,7 @@ function Test-McpJsonConfigured($configPath) {
     }
 }
 
-# Add MCP server to Antigravity config (flat top-level keys, no mcpServers wrapper)
+# Antigravity 설정에 canonical mcpServers 래퍼로 MCP 서버를 추가하고 legacy flat key를 정리
 function Add-AntigravityMcpConfig($configPath) {
     $parentDir = Split-Path $configPath -Parent
     if (-not (Test-Path $parentDir)) { New-Item -ItemType Directory -Path $parentDir -Force | Out-Null }
@@ -150,7 +150,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');
 "@
     } finally {
@@ -165,7 +178,10 @@ function Test-AntigravityMcpConfigured($configPath) {
 
     try {
         $config = Get-Content -Path $configPath -Raw | ConvertFrom-Json
-        return $null -ne $config.'weppy-roblox-mcp'
+        $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')
+        return ($server.command -eq 'npx') -and $hasCanonicalArgs -and (-not $hasLegacyFlatKey)
     }
     catch {
         return $false
@@ -177,7 +193,421 @@ function Test-CodexConfigConfigured($configPath) {
         return $false
     }
 
-    return Select-String -Path $configPath -Pattern '^\s*\[mcp_servers\.weppy-roblox-mcp\]\s*$' -Quiet
+    $env:MCP_CODEX_CONFIG_PATH = $configPath
+    try {
+        node -e @"
+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);
+}
+"@
+        return $LASTEXITCODE -eq 0
+    }
+    finally {
+        Remove-Item Env:\MCP_CODEX_CONFIG_PATH -ErrorAction SilentlyContinue
+    }
 }
 
 # Add MCP server to JSON config file (PowerShell 5.1 compatible — edits JSON via node)