@softerist/heuristic-mcp 2.1.10 → 2.1.11

package/README.md

@@ -196,6 +196,14 @@ heuristic-mcp --start
 
 *(This re-runs the configuration step to ensure it is enabled in your IDE)*
 
+**Check Status:**
+
+```bash
+heuristic-mcp --status
+```
+
+*(Shows if the server is running and its PID)*
+
 ---
 
 ## Environment Variables
@@ -278,6 +286,7 @@ The server indexes your code in four steps:
 4. **Storage**: Saves embeddings to `.smart-coding-cache/` for fast startup
 
 When you search, your query is converted to the same vector format. We use a **hybrid ranking algorithm** that combines:
+
 - **Semantic Similarity** (cosine similarity of vectors)
 - **Exact Keyword Matching** (BM25-inspired boost)
 - **Recency Boosting** (favoring files you're actively working on)
@@ -332,7 +341,7 @@ Finds all try/catch blocks and error handling patterns.
 
 This project builds on research from Cursor showing that semantic search improves AI coding agent performance by 12.5% on average across question-answering tasks. The key insight is that AI assistants benefit more from relevant context than from large amounts of context.
 
-See: https://cursor.com/blog/semsearch
+See: <https://cursor.com/blog/semsearch>
 
 ## Acknowledgements
 

package/features/lifecycle.js

@@ -45,3 +45,33 @@ export async function start() {
         console.error(`[Lifecycle] Failed to configure server: ${err.message}`);
     }
 }
+
+export async function status() {
+    try {
+        const platform = process.platform;
+        let command = '';
+
+        if (platform === 'win32') {
+            command = `wmic process where "CommandLine like '%heuristic-mcp/index.js%'" get ProcessId`;
+        } else {
+            // pgrep -f matches the full command line
+            command = `pgrep -f "heuristic-mcp/index.js"`;
+        }
+
+        const { stdout } = await execPromise(command);
+        const pids = stdout.trim().split(/\s+/).filter(pid => pid && !isNaN(pid));
+
+        if (pids.length > 0) {
+            console.log(`[Lifecycle] 🟢 Server is RUNNING. PID(s): ${pids.join(', ')}`);
+        } else {
+            console.log('[Lifecycle] ⚪ Server is STOPPED.');
+        }
+    } catch (error) {
+        // pgrep returns exit code 1 if no process found
+        if (error.code === 1 || error.code === '1' || error.message.includes('No Instance(s) Available')) {
+             console.log('[Lifecycle] ⚪ Server is STOPPED.');
+        } else {
+             console.error(`[Lifecycle] Failed to check status: ${error.message}`);
+        }
+    }
+}

package/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { stop, start } from "./features/lifecycle.js";
+import { stop, start, status } 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";
@@ -36,6 +36,11 @@ if (args.includes('--start')) {
   process.exit(0);
 }
 
+if (args.includes('--status')) {
+  await status();
+  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.10",
+  "version": "2.1.11",
   "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",