gdep-mcp 0.1.7 → 0.1.11

package/README.md

@@ -1,76 +1,76 @@
-# gdep-mcp
-
-> MCP server for [gdep](https://github.com/pirua-game/gdep) — Game Codebase Analysis Tool
-
-Enables Claude Desktop, Cursor, and other MCP-compatible AI agents to analyze game projects
-(Unity, Unreal Engine 5, C++, C#) using gdep.
-
-## Install
-
-```bash
-npm install -g gdep-mcp
-```
-
-Automatically installs the `gdep` Python package and `mcp[cli]` dependencies.
-
-## Usage
-
-Add to your AI agent config:
-
-**Claude Desktop** (`claude_desktop_config.json`):
-```json
-{
-  "mcpServers": {
-    "gdep": {
-      "command": "gdep-mcp"
-    }
-  }
-}
-```
-
-**Cursor** (`.cursor/mcp.json`):
-```json
-{
-  "mcpServers": {
-    "gdep": {
-      "command": "gdep-mcp"
-    }
-  }
-}
-```
-
-> Each tool accepts `project_path` as a call parameter — no path needed in the config.
-
-## Requirements
-
-- Node.js 18+
-- Python 3.11+
-- .NET Runtime 8.0+ (for C#/Unity analysis)
-
-## Available Tools (13)
-
-| Tool | Description |
-|------|-------------|
-| `get_project_context` | Project overview — call first |
-| `analyze_impact_and_risk` | Change impact + lint |
-| `trace_gameplay_flow` | Call chain tracing (C++→BP) |
-| `inspect_architectural_health` | Tech debt diagnosis |
-| `explore_class_semantics` | Class structure + AI summary |
-| `execute_gdep_cli` | Raw CLI access |
-| `find_unity_event_bindings` | Unity Inspector bindings |
-| `analyze_unity_animator` | Unity Animator state machine |
-| `analyze_ue5_gas` | UE5 GAS full analysis |
-| `analyze_ue5_behavior_tree` | BehaviorTree structure |
-| `analyze_ue5_state_tree` | StateTree structure |
-| `analyze_ue5_animation` | ABP + Montage analysis |
-| `analyze_ue5_blueprint_mapping` | C++ → Blueprint mapping |
-
-## Links
-
-- [GitHub Repository](https://github.com/pirua-game/gdep)
-- [Full Documentation](https://github.com/pirua-game/gdep/blob/main/README.md)
-- [Benchmark](https://github.com/pirua-game/gdep/blob/main/docs/BENCHMARK.md)
-
-## License
-
-Apache-2.0
+# gdep-mcp
+
+> MCP server for [gdep](https://github.com/pirua-game/gdep) — Game Codebase Analysis Tool
+
+Enables Claude Desktop, Cursor, and other MCP-compatible AI agents to analyze game projects
+(Unity, Unreal Engine 5, C++, C#) using gdep.
+
+## Install
+
+```bash
+npm install -g gdep-mcp
+```
+
+Automatically installs the `gdep` Python package and `mcp[cli]` dependencies.
+
+## Usage
+
+Add to your AI agent config:
+
+**Claude Desktop** (`claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "gdep": {
+      "command": "gdep-mcp"
+    }
+  }
+}
+```
+
+**Cursor** (`.cursor/mcp.json`):
+```json
+{
+  "mcpServers": {
+    "gdep": {
+      "command": "gdep-mcp"
+    }
+  }
+}
+```
+
+> Each tool accepts `project_path` as a call parameter — no path needed in the config.
+
+## Requirements
+
+- Node.js 18+
+- Python 3.11+
+- .NET Runtime 8.0+ (for C#/Unity analysis)
+
+## Available Tools (13)
+
+| Tool | Description |
+|------|-------------|
+| `get_project_context` | Project overview — call first |
+| `analyze_impact_and_risk` | Change impact + lint |
+| `trace_gameplay_flow` | Call chain tracing (C++→BP) |
+| `inspect_architectural_health` | Tech debt diagnosis |
+| `explore_class_semantics` | Class structure + AI summary |
+| `execute_gdep_cli` | Raw CLI access |
+| `find_unity_event_bindings` | Unity Inspector bindings |
+| `analyze_unity_animator` | Unity Animator state machine |
+| `analyze_ue5_gas` | UE5 GAS full analysis |
+| `analyze_ue5_behavior_tree` | BehaviorTree structure |
+| `analyze_ue5_state_tree` | StateTree structure |
+| `analyze_ue5_animation` | ABP + Montage analysis |
+| `analyze_ue5_blueprint_mapping` | C++ → Blueprint mapping |
+
+## Links
+
+- [GitHub Repository](https://github.com/pirua-game/gdep)
+- [Full Documentation](https://github.com/pirua-game/gdep/blob/main/README.md)
+- [Benchmark](https://github.com/pirua-game/gdep/blob/main/docs/BENCHMARK.md)
+
+## License
+
+Apache-2.0

package/bin/gdep-mcp.js

@@ -5,26 +5,38 @@
  * Usage: gdep-mcp
  */
 
-const { spawn, execSync } = require('child_process');
+const { spawn, spawnSync } = require('child_process');
 const os   = require('os');
 const fs   = require('fs');
 const path = require('path');
 
 const isWin = os.platform() === 'win32';
 
-// ── Find Python 3.11+ (same logic as postinstall) ─────────────
+// ── Find Python 3.11+ ─────────────────────────────────────────
+// Returns { exe: string, extraArgs: string[] } or null.
+// Uses array-based spawnSync to avoid shell interpretation issues
+// with paths containing spaces.
 function findPython() {
   const candidates = isWin
-    ? ['py -3.11', 'py -3.12', 'py -3.13', 'python3.11', 'python3', 'python']
-    : ['python3.11', 'python3.12', 'python3.13', 'python3', 'python'];
+    ? [['py', '-3.11'], ['py', '-3.12'], ['py', '-3.13'], ['python3.11'], ['python3'], ['python']]
+    : [['python3.11'], ['python3.12'], ['python3.13'], ['python3'], ['python']];
 
-  for (const cmd of candidates) {
+  for (const parts of candidates) {
     try {
-      const ver = execSync(`${cmd} --version`, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] }).trim();
+      const args = [...parts.slice(1), '--version'];
+      const result = spawnSync(parts[0], args, {
+        encoding: 'utf8',
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 5000,
+      });
+      if (result.status !== 0) continue;
+      const ver = (result.stdout || '').trim();
       const m = ver.match(/Python (\d+)\.(\d+)/);
       if (m) {
         const [, major, minor] = m.map(Number);
-        if (major === 3 && minor >= 11) return cmd;
+        if (major === 3 && minor >= 11) {
+          return { exe: parts[0], extraArgs: parts.slice(1) };
+        }
       }
     } catch {}
   }
@@ -32,41 +44,39 @@ function findPython() {
 }
 
 // ── Find gdep MCP server.py via pip show ──────────────────────
-function findServerScript(pyCmd) {
+function findServerScript(py) {
   try {
-    const pipShow = execSync(`${pyCmd} -m pip show gdep`, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] });
-    const m = pipShow.match(/Location: (.+)/);
+    const result = spawnSync(py.exe, [...py.extraArgs, '-m', 'pip', 'show', 'gdep'], {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 10000,
+    });
+    const out = result.stdout || '';
+    const m = out.match(/Location: (.+)/);
     if (m) {
       const candidate = path.join(m[1].trim(), 'gdep_mcp', 'server.py');
       if (fs.existsSync(candidate)) return candidate;
-      // Also try gdep-mcp subdir
-      const candidate2 = path.join(m[1].trim(), 'gdep', 'gdep-mcp', 'server.py');
-      if (fs.existsSync(candidate2)) return candidate2;
     }
   } catch {}
   return null;
 }
 
-const pyCmd = findPython();
-if (!pyCmd) {
+const py = findPython();
+if (!py) {
   console.error('Python 3.11+ not found. Install gdep manually:');
   console.error('  pip install gdep "mcp[cli]"');
   process.exit(1);
 }
 
-// Split "py -3.11" into ["py", "-3.11"]
-const cmdParts   = pyCmd.split(' ');
-const pyExe      = cmdParts[0];
-const pyExtraArgs= cmdParts.slice(1);
-
-const serverScript = findServerScript(pyCmd);
+const serverScript = findServerScript(py);
 const spawnArgs = serverScript
-  ? [...pyExtraArgs, serverScript]
-  : [...pyExtraArgs, '-m', 'gdep_mcp.server'];
+  ? [...py.extraArgs, serverScript]
+  : [...py.extraArgs, '-m', 'gdep_mcp.server'];
 
-const child = spawn(pyExe, spawnArgs, {
+// shell: false — safe for paths with spaces (e.g. C:\Users\xxx yyy\...)
+const child = spawn(py.exe, spawnArgs, {
   stdio: 'inherit',
-  shell: isWin,
+  shell: false,
   env: { ...process.env, PYTHONUTF8: '1' },
 });
 

package/bin/postinstall.js

@@ -13,30 +13,41 @@ const YELLOW= '\x1b[33m';
 const CYAN  = '\x1b[36m';
 const RESET = '\x1b[0m';
 
-function ok(msg)   { console.log(`${GREEN}✓${RESET} ${msg}`); }
-function warn(msg) { console.log(`${YELLOW}⚠${RESET}  ${msg}`); }
-function info(msg) { console.log(`${CYAN}→${RESET} ${msg}`); }
+function ok(msg)   { console.log(`${GREEN}\u2713${RESET} ${msg}`); }
+function warn(msg) { console.log(`${YELLOW}\u26A0${RESET}  ${msg}`); }
+function info(msg) { console.log(`${CYAN}\u2192${RESET} ${msg}`); }
 
 console.log(`\n${BOLD}gdep-mcp postinstall${RESET}\n`);
 
-// ── 1. Find Python 3.11+ ──────────────────────────────────────
-// Try candidates in order: py -3.11 (Windows launcher), python3.11, python3, python
 const isWin = os.platform() === 'win32';
+
+// ── 1. Find Python 3.11+ ──────────────────────────────────────
+// Array-based spawnSync to avoid shell interpretation issues
+// with paths containing spaces (e.g. C:\Users\xxx yyy\...).
 const candidates = isWin
-  ? ['py -3.11', 'py -3.12', 'py -3.13', 'python3.11', 'python3', 'python']
-  : ['python3.11', 'python3.12', 'python3.13', 'python3', 'python'];
+  ? [['py', '-3.11'], ['py', '-3.12'], ['py', '-3.13'], ['python3.11'], ['python3'], ['python']]
+  : [['python3.11'], ['python3.12'], ['python3.13'], ['python3'], ['python']];
 
-let pyCmd = null;
+let pyExe = null;
+let pyExtraArgs = [];
 let pyVersion = null;
 
-for (const cmd of candidates) {
+for (const parts of candidates) {
   try {
-    const ver = execSync(`${cmd} --version`, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] }).trim();
+    const args = [...parts.slice(1), '--version'];
+    const result = spawnSync(parts[0], args, {
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: 5000,
+    });
+    if (result.status !== 0) continue;
+    const ver = (result.stdout || '').trim();
     const m = ver.match(/Python (\d+)\.(\d+)/);
     if (m) {
       const [, major, minor] = m.map(Number);
       if (major === 3 && minor >= 11) {
-        pyCmd = cmd;
+        pyExe = parts[0];
+        pyExtraArgs = parts.slice(1);
         pyVersion = ver;
         break;
       }
@@ -44,27 +55,26 @@ for (const cmd of candidates) {
   } catch {}
 }
 
-if (!pyCmd) {
+if (!pyExe) {
   warn('Python 3.11+ not found. Please install it and run manually:');
   warn('  pip install gdep "mcp[cli]"');
   warn('  Download: https://www.python.org/downloads/');
   process.exit(0);
 }
 
-ok(`Python found: ${pyVersion}  (using: ${pyCmd})`);
+ok(`Python found: ${pyVersion}  (using: ${pyExe}${pyExtraArgs.length ? ' ' + pyExtraArgs.join(' ') : ''})`);
 
 // ── 2. pip install gdep + mcp[cli] ────────────────────────────
 info('Installing gdep and mcp[cli]...');
 
-// For "py -3.11" style commands, split into args
-const cmdParts = pyCmd.split(' ');
-const pipArgs = [...cmdParts.slice(1), '-m', 'pip', 'install', '--upgrade', 'gdep', 'mcp[cli]'];
+const pipArgs = [...pyExtraArgs, '-m', 'pip', 'install', '--upgrade', 'gdep', 'mcp[cli]'];
 
-const result = spawnSync(cmdParts[0], pipArgs, { stdio: 'inherit', shell: isWin });
+// shell: false — safe for paths with spaces
+const result = spawnSync(pyExe, pipArgs, { stdio: 'inherit', shell: false });
 
 if (result.status !== 0) {
   warn('pip install failed. Try manually:');
-  warn(`  ${pyCmd} -m pip install gdep "mcp[cli]"`);
+  warn(`  ${pyExe}${pyExtraArgs.length ? ' ' + pyExtraArgs.join(' ') : ''} -m pip install gdep "mcp[cli]"`);
   process.exit(0);
 }
 
@@ -72,27 +82,31 @@ ok('gdep and mcp[cli] installed!');
 
 // ── 3. Check gdep is on PATH ──────────────────────────────────
 try {
-  execSync('gdep --help', { stdio: 'pipe' });
-  ok('gdep command is available on PATH.');
+  const check = spawnSync('gdep', ['--help'], { stdio: 'pipe', timeout: 10000 });
+  if (check.status === 0) {
+    ok('gdep command is available on PATH.');
+  } else {
+    throw new Error('non-zero exit');
+  }
 } catch {
   warn('gdep was installed but is not on PATH.');
   warn('Add the Python Scripts folder to your PATH, e.g.:');
   if (isWin) {
-    // Try to find the actual scripts path
     try {
-      const scripts = execSync(`${pyCmd} -c "import sysconfig; print(sysconfig.get_path('scripts'))"`,
-        { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] }).trim();
-      warn(`  ${scripts}`);
+      const scripts = spawnSync(pyExe, [...pyExtraArgs, '-c',
+        'import sysconfig; print(sysconfig.get_path("scripts"))'],
+        { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] });
+      if (scripts.stdout) warn(`  ${scripts.stdout.trim()}`);
     } catch {}
-    warn('  (System Properties → Environment Variables → Path)');
+    warn('  (System Properties \u2192 Environment Variables \u2192 Path)');
   } else {
     warn('  export PATH="$PATH:$(python3 -m site --user-base)/bin"');
   }
 }
 
-// ── 3. Print config ───────────────────────────────────────────
+// ── 4. Print config ───────────────────────────────────────────
 console.log(`
-${BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
+${BOLD}\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${RESET}
 ${GREEN}${BOLD} gdep-mcp ready!${RESET}
 
 Add to Claude Desktop (claude_desktop_config.json):
@@ -107,5 +121,5 @@ ${CYAN}{
 
 Each tool call passes project_path as a parameter.
 
-${BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
+${BOLD}\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501${RESET}
 `);

package/package.json

@@ -1,26 +1,26 @@
-{
-  "name": "gdep-mcp",
-  "version": "0.1.7",
-  "description": "MCP server for gdep — Game Codebase Analysis Tool (Unity/UE5/C++/C#)",
-  "keywords": ["mcp", "game", "unity", "unreal", "ue5", "dependency", "analysis", "claude", "cursor", "ai"],
-  "author": "pirua-game",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/pirua-game/gdep.git"
-  },
-  "homepage": "https://github.com/pirua-game/gdep",
-  "bin": {
-    "gdep-mcp": "./bin/gdep-mcp.js"
-  },
-  "scripts": {
-    "postinstall": "node bin/postinstall.js"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "files": [
-    "bin/",
-    "README.md"
-  ]
-}
+{
+  "name": "gdep-mcp",
+  "version": "0.1.11",
+  "description": "MCP server for gdep — Game Codebase Analysis Tool (Unity/UE5/C++/C#)",
+  "keywords": ["mcp", "game", "unity", "unreal", "ue5", "dependency", "analysis", "claude", "cursor", "ai"],
+  "author": "pirua-game",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pirua-game/gdep.git"
+  },
+  "homepage": "https://github.com/pirua-game/gdep",
+  "bin": {
+    "gdep-mcp": "./bin/gdep-mcp.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/postinstall.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ]
+}