@softerist/heuristic-mcp 2.1.4 → 2.1.6

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,20 +168,34 @@ Add the server configuration to the `mcpServers` object in your config file:
 }
 ```
 
-### Auto-Fix Configuration (New!)
+### Troubleshooting
 
-To automatically configure your IDEs (Antigravity, Claude, Cursor) with the correct path:
+If for some reason the server isn't detected automatically, you can trigger the registration manually:
 
 ```bash
 heuristic-mcp --register
 ```
 
-This will automatically find your IDE config files and inject the correct absolute path to the server. You can also target a specific IDE:
+### Starting and Stopping
+
+If you need to restart the server or kill a zombie process:
+
+**Stop the server:**
 
 ```bash
-heuristic-mcp --register antigravity
+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

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

@@ -62,7 +62,7 @@ export async function register(filter = null) {
 
   const serverConfig = {
     command: binaryPath,
-    args: [scriptPath, "--workspace", process.cwd()],
+    args: [scriptPath, "--workspace", "${workspaceFolder}"],
     disabled: false,
     autoRegistered: true // Marker to know we did this
   };
@@ -106,7 +106,7 @@ export async function register(filter = null) {
 
       // Write back
       await fs.writeFile(configPath, JSON.stringify(config, null, 2));
-      console.log(`[Auto-Register] ✅ Successfully registered with ${name}`);
+      console.log(`\x1b[32m[Auto-Register] ✅ Successfully registered with ${name}\x1b[0m`);
       registeredCount++;
 
     } catch (err) {
@@ -117,5 +117,22 @@ export async function register(filter = null) {
   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)}`);
+  } else {
+    // Friendly Banner
+    console.log('\n\x1b[36m' + '='.repeat(60));
+    console.log('   🚀 Heuristic MCP Installed & Configured!   ');
+    console.log('='.repeat(60) + '\x1b[0m');
+    console.log(`
+\x1b[33mACTION REQUIRED:\x1b[0m
+1. \x1b[1mRestart your IDE\x1b[0m (or reload the window) to load the new config.
+2. The server will start automatically in the background.
+
+\x1b[32mSTATUS:\x1b[0m
+- \x1b[1mIndexing:\x1b[0m Will begin immediately after restart.
+- \x1b[1mUsage:\x1b[0m You can work while it indexes (it catches up!).
+- \x1b[1mLogs:\x1b[0m Check your IDE's MCP logs if you are curious.
+
+\x1b[36mHappy Coding! 🤖\x1b[0m
+    `);
   }
 }

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";
@@ -24,6 +25,16 @@ 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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softerist/heuristic-mcp",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "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",