gdep-mcp 0.1.0 → 0.1.3

package/bin/gdep-mcp.js

@@ -1,57 +1,79 @@
 #!/usr/bin/env node
 /**
  * gdep-mcp — CLI entry point
- *
- * Usage:
- *   gdep-mcp
- *
  * Launches the gdep MCP server (Python).
- * Each tool call passes project_path as a parameter — no args needed here.
- * The Python gdep package must be installed: pip install gdep
+ * Usage: gdep-mcp
  */
 
-const { spawn } = require('child_process');
-const os = require('os');
-const fs = require('fs');
+const { spawn, execSync } = require('child_process');
+const os   = require('os');
+const fs   = require('fs');
 const path = require('path');
 
-const pyCmd = os.platform() === 'win32' ? 'python' : 'python3';
+const isWin = os.platform() === 'win32';
 
-function findServerScript() {
-  const { execSync } = require('child_process');
+// ── Find Python 3.11+ (same logic as postinstall) ─────────────
+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'];
+
+  for (const cmd of candidates) {
+    try {
+      const ver = execSync(`${cmd} --version`, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] }).trim();
+      const m = ver.match(/Python (\d+)\.(\d+)/);
+      if (m) {
+        const [, major, minor] = m.map(Number);
+        if (major === 3 && minor >= 11) return cmd;
+      }
+    } catch {}
+  }
+  return null;
+}
+
+// ── Find gdep MCP server.py via pip show ──────────────────────
+function findServerScript(pyCmd) {
   try {
-    const pipShow = execSync(`${pyCmd} -m pip show gdep`, { encoding: 'utf8' });
-    const locationMatch = pipShow.match(/Location: (.+)/);
-    if (locationMatch) {
-      // pip install gdep installs to site-packages/gdep_mcp/server.py
-      const candidate = path.join(locationMatch[1].trim(), 'gdep_mcp', 'server.py');
+    const pipShow = execSync(`${pyCmd} -m pip show gdep`, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] });
+    const m = pipShow.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 serverScript = findServerScript();
-
-let child;
-if (serverScript) {
-  child = spawn(pyCmd, [serverScript], {
-    stdio: 'inherit',
-    env: { ...process.env, PYTHONUTF8: '1' },
-  });
-} else {
-  child = spawn(pyCmd, ['-m', 'gdep_mcp.server'], {
-    stdio: 'inherit',
-    env: { ...process.env, PYTHONUTF8: '1' },
-  });
+const pyCmd = findPython();
+if (!pyCmd) {
+  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 spawnArgs = serverScript
+  ? [...pyExtraArgs, serverScript]
+  : [...pyExtraArgs, '-m', 'gdep_mcp.server'];
+
+const child = spawn(pyExe, spawnArgs, {
+  stdio: 'inherit',
+  shell: isWin,
+  env: { ...process.env, PYTHONUTF8: '1' },
+});
+
 child.on('error', (err) => {
   console.error(`Failed to start gdep MCP server: ${err.message}`);
   console.error('Make sure gdep is installed: pip install gdep "mcp[cli]"');
   process.exit(1);
 });
 
-child.on('exit', (code) => {
-  process.exit(code ?? 0);
-});
+child.on('exit', (code) => process.exit(code ?? 0));

package/bin/postinstall.js

@@ -1,85 +1,111 @@
 #!/usr/bin/env node
 /**
  * gdep-mcp — postinstall script
- *
- * Automatically installs the gdep Python package and MCP dependencies
- * after `npm install -g gdep-mcp`.
- *
- * Steps:
- *   1. Check Python 3.11+ is available
- *   2. pip install gdep  (from PyPI)
- *   3. pip install "mcp[cli]"
- *   4. Print Claude Desktop config snippet
+ * Installs the gdep Python package after `npm install -g gdep-mcp`.
  */
 
 const { execSync, spawnSync } = require('child_process');
-const path = require('path');
 const os = require('os');
 
-const BOLD = '\x1b[1m';
+const BOLD  = '\x1b[1m';
 const GREEN = '\x1b[32m';
-const YELLOW = '\x1b[33m';
-const CYAN = '\x1b[36m';
+const YELLOW= '\x1b[33m';
+const CYAN  = '\x1b[36m';
 const RESET = '\x1b[0m';
 
-function log(msg)  { console.log(msg); }
 function ok(msg)   { console.log(`${GREEN}✓${RESET} ${msg}`); }
 function warn(msg) { console.log(`${YELLOW}⚠${RESET}  ${msg}`); }
 function info(msg) { console.log(`${CYAN}→${RESET} ${msg}`); }
 
-log(`\n${BOLD}gdep-mcp postinstall${RESET}\n`);
+console.log(`\n${BOLD}gdep-mcp postinstall${RESET}\n`);
 
-// ── 1. Python check ───────────────────────────────────────────
-const pyCmd = os.platform() === 'win32' ? 'python' : 'python3';
+// ── 1. Find Python 3.11+ ──────────────────────────────────────
+// Try candidates in order: py -3.11 (Windows launcher), python3.11, python3, python
+const isWin = os.platform() === 'win32';
+const candidates = isWin
+  ? ['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 pyVersion = null;
-try {
-  pyVersion = execSync(`${pyCmd} --version`, { encoding: 'utf8' }).trim();
-  ok(`Python found: ${pyVersion}`);
-} catch {
-  warn('Python 3.11+ not found. Please install Python and re-run:');
-  warn('  pip install gdep "mcp[cli]"');
-  process.exit(0); // soft fail — don't block npm install
+
+for (const cmd of candidates) {
+  try {
+    const ver = execSync(`${cmd} --version`, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] }).trim();
+    const m = ver.match(/Python (\d+)\.(\d+)/);
+    if (m) {
+      const [, major, minor] = m.map(Number);
+      if (major === 3 && minor >= 11) {
+        pyCmd = cmd;
+        pyVersion = ver;
+        break;
+      }
+    }
+  } catch {}
 }
 
-const versionMatch = pyVersion.match(/Python (\d+)\.(\d+)/);
-if (versionMatch) {
-  const [, major, minor] = versionMatch.map(Number);
-  if (major < 3 || (major === 3 && minor < 11)) {
-    warn(`Python 3.11+ required (found ${major}.${minor}). Please upgrade.`);
-    process.exit(0);
-  }
+if (!pyCmd) {
+  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);
 }
 
-// ── 2. pip install gdep ───────────────────────────────────────
-info('Installing gdep Python package...');
-const pipInstall = spawnSync(pyCmd, ['-m', 'pip', 'install', '--upgrade', 'gdep', 'mcp[cli]'], {
-  stdio: 'inherit',
-  shell: true,
-});
+ok(`Python found: ${pyVersion}  (using: ${pyCmd})`);
+
+// ── 2. pip install gdep + mcp[cli] ────────────────────────────
+info('Installing gdep and mcp[cli]...');
 
-if (pipInstall.status !== 0) {
-  warn('pip install failed. Try manually: pip install gdep "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 result = spawnSync(cmdParts[0], pipArgs, { stdio: 'inherit', shell: isWin });
+
+if (result.status !== 0) {
+  warn('pip install failed. Try manually:');
+  warn(`  ${pyCmd} -m pip install gdep "mcp[cli]"`);
   process.exit(0);
 }
-ok('gdep and mcp[cli] installed successfully.');
 
-// ── 3. Print config snippet ───────────────────────────────────
-const serverScript = path.join(__dirname, 'server.js');
-log(`
+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.');
+} 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}`);
+    } catch {}
+    warn('  (System Properties → Environment Variables → Path)');
+  } else {
+    warn('  export PATH="$PATH:$(python3 -m site --user-base)/bin"');
+  }
+}
+
+// ── 3. Print config ───────────────────────────────────────────
+console.log(`
 ${BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
-${GREEN}${BOLD} gdep-mcp installed!${RESET}
+${GREEN}${BOLD} gdep-mcp ready!${RESET}
 
-Add this to your Claude Desktop config
-(claude_desktop_config.json):
+Add to Claude Desktop (claude_desktop_config.json):
 
 ${CYAN}{
   "mcpServers": {
     "gdep": {
-      "command": "gdep-mcp",
-      "args": ["/path/to/your/game/project"]
+      "command": "gdep-mcp"
     }
   }
 }${RESET}
 
+Each tool call passes project_path as a parameter.
+
 ${BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${RESET}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gdep-mcp",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "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",