@softerist/heuristic-mcp 2.1.3 → 2.1.5

package/README.md

@@ -126,15 +126,7 @@ Install globally via npm:
 npm install -g @softerist/heuristic-mcp
 ```
 
-To update to the latest version:
-
-```bash
-npm update -g @softerist/heuristic-mcp
-```
-
-## Configuration
-
-Add to your MCP configuration file. The location depends on your IDE and OS:
+That's it! The installer will automatically detect your IDE (Antigravity, Claude, Cursor) and configure it for you.
 
 | IDE                  | OS      | Config Path                                                       |
 | -------------------- | ------- | ----------------------------------------------------------------- |
@@ -176,6 +168,36 @@ Add the server configuration to the `mcpServers` object in your config file:
 }
 ```
 
+### Troubleshooting
+
+If for some reason the server isn't detected automatically, you can trigger the registration manually:
+
+```bash
+heuristic-mcp --register
+```
+
+### Starting and Stopping
+
+If you need to restart the server or kill a zombie process:
+
+**Stop the server:**
+
+```bash
+heuristic-mcp --stop
+```
+
+*(This kills any running instances of the server)*
+
+**Start/Enable the server:**
+
+```bash
+heuristic-mcp --start
+```
+
+*(This re-runs the configuration step to ensure it is enabled in your IDE)*
+
+---
+
 ## Environment Variables
 
 Override configuration settings via environment variables in your MCP config:

package/features/lifecycle.js

@@ -0,0 +1,45 @@
+import { exec } from 'child_process';
+import util from 'util';
+const execPromise = util.promisify(exec);
+
+export async function stop() {
+  console.log('[Lifecycle] Stopping Heuristic MCP servers...');
+  try {
+    const platform = process.platform;
+    let command = '';
+
+    if (platform === 'win32') {
+      // Windows: Use wmic to find node processes running our script
+      command = `wmic process where "CommandLine like '%heuristic-mcp/index.js%'" delete`;
+    } else {
+      // Unix/Linux/Mac: Use pkill to find the process matching the script path
+      // We exclude the current process to avoid suicide if we are running from the same script
+      // however, usually the CLI runner is a different PID than the server.
+      command = `pkill -f "heuristic-mcp/index.js"`;
+    }
+
+    await execPromise(command);
+    console.log('[Lifecycle] ✅ Stopped all running instances.');
+  } catch (error) {
+    // pkill returns non-zero if no process found, which is fine
+    if (error.code === 1 || error.message.includes('No Instance(s) Available')) {
+      console.log('[Lifecycle] No running instances found.');
+    } else {
+      // Don't fail hard, just warn
+      console.warn(`[Lifecycle] Note: Could not stop server (it might not be running). Detail: ${error.message}`);
+    }
+  }
+}
+
+export async function start() {
+    console.log('[Lifecycle] Ensuring server is configured...');
+    // Re-use the registration logic to ensure the config is present and correct
+    try {
+        const { register } = await import('./register.js');
+        await register();
+        console.log('[Lifecycle] ✅ Configuration checked.');
+        console.log('[Lifecycle] To start the server, please reload your IDE window or restart the IDE.');
+    } catch (err) {
+        console.error(`[Lifecycle] Failed to configure server: ${err.message}`);
+    }
+}

package/features/register.js

@@ -0,0 +1,121 @@
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+
+// Helper to expand ~ and %vars%
+function expandPath(p) {
+  if (p.startsWith('~/')) {
+    return path.join(os.homedir(), p.slice(2));
+  }
+
+  if (process.platform === 'win32') {
+    return p.replace(/%([^%]+)%/g, (_, n) => process.env[n] || '%' + n + '%');
+  }
+
+  return p;
+}
+
+// Known config paths for different IDEs
+function getConfigPaths() {
+  const platform = process.platform;
+  const home = os.homedir();
+  const paths = [];
+
+  // Antigravity
+  if (platform === 'win32') {
+    paths.push({
+      name: 'Antigravity',
+      path: expandPath('%USERPROFILE%\\.gemini\\antigravity\\mcp_config.json')
+    });
+  } else {
+    paths.push({
+      name: 'Antigravity',
+      path: expandPath('~/.gemini/antigravity/mcp_config.json')
+    });
+  }
+
+  // Claude Desktop
+  if (platform === 'darwin') {
+    paths.push({
+      name: 'Claude Desktop',
+      path: expandPath('~/Library/Application Support/Claude/claude_desktop_config.json')
+    });
+  } else if (platform === 'win32') {
+    paths.push({
+      name: 'Claude Desktop',
+      path: expandPath('%APPDATA%\\Claude\\claude_desktop_config.json')
+    });
+  }
+
+  // Cursor (Cascade) - Settings are usually in settings.json but MCP might have a specific spot?
+  // Cursor often uses VS Code's settings.json for some things, but explicit MCP support varies.
+  // For now, we'll stick to Antigravity and Claude as confirmed targets.
+  // NOTE: If Cursor adds a specific mcp_config, add it here.
+
+  return paths;
+}
+
+export async function register(filter = null) {
+  const binaryPath = process.execPath; // The node binary
+  const scriptPath = fileURLToPath(new URL('../index.js', import.meta.url)); // Absolute path to index.js
+
+  const serverConfig = {
+    command: binaryPath,
+    args: [scriptPath, "--workspace", "${workspaceFolder}"],
+    disabled: false,
+    autoRegistered: true // Marker to know we did this
+  };
+
+  const configPaths = getConfigPaths();
+  let registeredCount = 0;
+
+  console.log(`[Auto-Register] Detecting IDE configurations...`);
+
+  for (const { name, path: configPath } of configPaths) {
+    if (filter && name.toLowerCase() !== filter.toLowerCase()) {
+      continue;
+    }
+
+    try {
+      // Check if file exists
+      try {
+        await fs.access(configPath);
+      } catch {
+        console.log(`[Auto-Register] Skipped ${name}: Config file not found at ${configPath}`);
+        continue;
+      }
+
+      // Read config
+      const content = await fs.readFile(configPath, 'utf-8');
+      let config = {};
+      try {
+        config = JSON.parse(content);
+      } catch (e) {
+        console.error(`[Auto-Register] Error parsing ${name} config: ${e.message}`);
+        continue;
+      }
+
+      // Init mcpServers if missing
+      if (!config.mcpServers) {
+        config.mcpServers = {};
+      }
+
+      // Inject configuration
+      config.mcpServers['heuristic-mcp'] = serverConfig;
+
+      // Write back
+      await fs.writeFile(configPath, JSON.stringify(config, null, 2));
+      console.log(`[Auto-Register] ✅ Successfully registered with ${name}`);
+      registeredCount++;
+
+    } catch (err) {
+      console.error(`[Auto-Register] Failed to register with ${name}: ${err.message}`);
+    }
+  }
+
+  if (registeredCount === 0) {
+    console.log(`[Auto-Register] No compatible IDE configurations found to update.`);
+    console.log(`[Auto-Register] Manual Config:\n${JSON.stringify({ mcpServers: { "heuristic-mcp": serverConfig } }, null, 2)}`);
+  }
+}

package/index.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { stop, start } from "./features/lifecycle.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { pipeline } from "@xenova/transformers";
@@ -19,10 +20,33 @@ import * as IndexCodebaseFeature from "./features/index-codebase.js";
 import * as HybridSearchFeature from "./features/hybrid-search.js";
 import * as ClearCacheFeature from "./features/clear-cache.js";
 import * as FindSimilarCodeFeature from "./features/find-similar-code.js";
-import * as AnnConfigFeature from "./features/ann-config.js";
+import { register } from "./features/register.js";
 
 // Parse workspace from command line arguments
 const args = process.argv.slice(2);
+
+if (args.includes('--stop')) {
+  await stop();
+  process.exit(0);
+}
+
+if (args.includes('--start')) {
+  await start();
+  process.exit(0);
+}
+
+// Check if --register flag is present
+if (args.includes('--register')) {
+  // Extract optional filter (e.g. --register antigravity)
+  const filterIndex = args.indexOf('--register');
+  const filter = args[filterIndex + 1] && !args[filterIndex + 1].startsWith('-')
+                 ? args[filterIndex + 1]
+                 : null;
+
+  await register(filter);
+  process.exit(0);
+}
+
 const workspaceIndex = args.findIndex(arg => arg.startsWith('--workspace'));
 let workspaceDir = null;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softerist/heuristic-mcp",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "An enhanced MCP server providing intelligent semantic code search with find-similar-code, recency ranking, and improved chunking. Fork of smart-coding-mcp.",
   "type": "module",
   "main": "index.js",
@@ -12,7 +12,8 @@
     "dev": "node --watch index.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "clear-cache": "node scripts/clear-cache.js"
+    "clear-cache": "node scripts/clear-cache.js",
+    "postinstall": "node index.js --register"
   },
   "keywords": [
     "mcp",