@softerist/heuristic-mcp 2.1.3 → 2.1.4

package/README.md

@@ -176,6 +176,22 @@ Add the server configuration to the `mcpServers` object in your config file:
 }
 ```
 
+### Auto-Fix Configuration (New!)
+
+To automatically configure your IDEs (Antigravity, Claude, Cursor) with the correct path:
+
+```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:
+
+```bash
+heuristic-mcp --register antigravity
+```
+
+---
+
 ## Environment Variables
 
 Override configuration settings via environment variables in your MCP config:

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", process.cwd()],
+    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

@@ -19,10 +19,23 @@ 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);
+
+// 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.4",
   "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",