smart-coding-mcp 1.2.1 → 1.2.3

package/README.md

@@ -38,7 +38,17 @@ npm install -g smart-coding-mcp
 
 ## Configuration
 
-Add to your MCP configuration file (e.g., `~/.config/claude/mcp.json` or similar):
+Add to your MCP configuration file. The location depends on your IDE and OS:
+
+| IDE                  | OS      | Config Path                                                       |
+| -------------------- | ------- | ----------------------------------------------------------------- |
+| **Claude Desktop**   | macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+| **Claude Desktop**   | Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |
+| **Cascade (Cursor)** | All     | Configured via UI Settings > Features > MCP                       |
+| **Antigravity**      | macOS   | `~/.gemini/antigravity/mcp_config.json`                           |
+| **Antigravity**      | Windows | `%USERPROFILE%\.gemini\antigravity\mcp_config.json`               |
+
+Add the server configuration to the `mcpServers` object in your config file:
 
 ### Option 1: Specific Project (Recommended)
 
@@ -86,14 +96,17 @@ Add to your MCP configuration file (e.g., `~/.config/claude/mcp.json` or similar
 
 Override configuration settings via environment variables in your MCP config:
 
-| Variable                      | Type    | Default   | Description                    |
-| ----------------------------- | ------- | --------- | ------------------------------ |
-| `SMART_CODING_VERBOSE`        | boolean | `false`   | Enable detailed logging        |
-| `SMART_CODING_BATCH_SIZE`     | number  | `100`     | Files to process in parallel   |
-| `SMART_CODING_MAX_FILE_SIZE`  | number  | `1048576` | Max file size in bytes (1MB)   |
-| `SMART_CODING_CHUNK_SIZE`     | number  | `15`      | Lines of code per chunk        |
-| `SMART_CODING_MAX_RESULTS`    | number  | `5`       | Max search results             |
-| `SMART_CODING_SMART_INDEXING` | boolean | `true`    | Enable smart project detection |
+| Variable                         | Type    | Default   | Description                           |
+| -------------------------------- | ------- | --------- | ------------------------------------- |
+| `SMART_CODING_VERBOSE`           | boolean | `false`   | Enable detailed logging               |
+| `SMART_CODING_BATCH_SIZE`        | number  | `100`     | Files to process in parallel          |
+| `SMART_CODING_MAX_FILE_SIZE`     | number  | `1048576` | Max file size in bytes (1MB)          |
+| `SMART_CODING_CHUNK_SIZE`        | number  | `15`      | Lines of code per chunk               |
+| `SMART_CODING_MAX_RESULTS`       | number  | `5`       | Max search results                    |
+| `SMART_CODING_SMART_INDEXING`    | boolean | `true`    | Enable smart project detection        |
+| `SMART_CODING_WATCH_FILES`       | boolean | `false`   | Enable file watching for auto-reindex |
+| `SMART_CODING_SEMANTIC_WEIGHT`   | number  | `0.7`     | Weight for semantic similarity (0-1)  |
+| `SMART_CODING_EXACT_MATCH_BOOST` | number  | `1.5`     | Boost for exact text matches          |
 
 **Example with environment variables:**
 
@@ -353,11 +366,24 @@ Potential areas for improvement:
 
 ## License
 
-MIT - see LICENSE file
+MIT License
+
+Copyright (c) 2025 Omar Haris
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-## Documentation
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-- ARCHITECTURE.md - Implementation details and design decisions
-- CONTRIBUTING.md - Guidelines for contributors
-- EXAMPLES.md - More usage examples
-- QUICKSTART.md - Detailed setup guide
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/config.json

@@ -1,7 +1,54 @@
 {
   "searchDirectory": ".",
-  "fileExtensions": ["js", "ts", "jsx", "tsx", "mjs", "cjs", "css", "scss", "sass", "less", "html", "htm", "xml", "svg", "py", "pyw", "java", "kt", "scala", "c", "cpp", "h", "hpp", "cs", "go", "rs", "rb", "php", "swift", "sh", "bash", "json", "yaml", "yml", "toml", "sql"],
-  "excludePatterns": ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.git/**", "**/coverage/**", "**/.next/**", "**/target/**", "**/vendor/**", "**/.smart-coding-cache/**"],
+  "fileExtensions": [
+    "js",
+    "ts",
+    "jsx",
+    "tsx",
+    "mjs",
+    "cjs",
+    "css",
+    "scss",
+    "sass",
+    "less",
+    "html",
+    "htm",
+    "xml",
+    "svg",
+    "py",
+    "pyw",
+    "java",
+    "kt",
+    "scala",
+    "c",
+    "cpp",
+    "h",
+    "hpp",
+    "cs",
+    "go",
+    "rs",
+    "rb",
+    "php",
+    "swift",
+    "sh",
+    "bash",
+    "json",
+    "yaml",
+    "yml",
+    "toml",
+    "sql"
+  ],
+  "excludePatterns": [
+    "**/node_modules/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/.git/**",
+    "**/coverage/**",
+    "**/.next/**",
+    "**/target/**",
+    "**/vendor/**",
+    "**/.smart-coding-cache/**"
+  ],
   "smartIndexing": true,
   "chunkSize": 15,
   "chunkOverlap": 3,
@@ -10,9 +57,9 @@
   "maxResults": 5,
   "enableCache": true,
   "cacheDirectory": "./.smart-coding-cache",
-  "watchFiles": true,
+  "watchFiles": false,
   "verbose": false,
   "embeddingModel": "Xenova/all-MiniLM-L6-v2",
   "semanticWeight": 0.7,
   "exactMatchBoost": 1.5
-}
+}

package/features/clear-cache.js

@@ -21,6 +21,13 @@ export function getToolDefinition() {
     inputSchema: {
       type: "object",
       properties: {}
+    },
+    annotations: {
+      title: "Clear Embeddings Cache",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false
     }
   };
 }

package/features/hybrid-search.js

@@ -89,6 +89,13 @@ export function getToolDefinition(config) {
         }
       },
       required: ["query"]
+    },
+    annotations: {
+      title: "Semantic Code Search",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
     }
   };
 }

package/features/index-codebase.js

@@ -161,11 +161,6 @@ export class CodebaseIndexer {
 
     console.error("[Indexer] File watcher enabled for incremental indexing");
   }
-
-  async initialize() {
-    await this.indexAll();
-    this.setupFileWatcher();
-  }
 }
 
 // MCP Tool definition for this feature
@@ -182,6 +177,13 @@ export function getToolDefinition() {
           default: false
         }
       }
+    },
+    annotations: {
+      title: "Reindex Codebase",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
     }
   };
 }

package/index.js

@@ -54,17 +54,17 @@ let indexer = null;
 let hybridSearch = null;
 let config = null;
 
-// Feature registry
+// Feature registry - ordered by priority (semantic_search first as primary tool)
 const features = [
   {
-    module: IndexCodebaseFeature,
+    module: HybridSearchFeature,
     instance: null,
-    handler: IndexCodebaseFeature.handleToolCall
+    handler: HybridSearchFeature.handleToolCall
   },
   {
-    module: HybridSearchFeature,
+    module: IndexCodebaseFeature,
     instance: null,
-    handler: HybridSearchFeature.handleToolCall
+    handler: IndexCodebaseFeature.handleToolCall
   },
   {
     module: ClearCacheFeature,
@@ -99,14 +99,19 @@ async function initialize() {
   hybridSearch = new HybridSearch(embedder, cache, config);
   const cacheClearer = new ClearCacheFeature.CacheClearer(embedder, cache, config);
 
-  // Store feature instances
-  features[0].instance = indexer;
-  features[1].instance = hybridSearch;
+  // Store feature instances (matches features array order)
+  features[0].instance = hybridSearch;
+  features[1].instance = indexer;
   features[2].instance = cacheClearer;
 
   // Start indexing in background (non-blocking)
   console.error("[Server] Starting background indexing...");
-  indexer.initialize().catch(err => {
+  indexer.indexAll().then(() => {
+    // Only start file watcher if explicitly enabled in config
+    if (config.watchFiles) {
+      indexer.setupFileWatcher();
+    }
+  }).catch(err => {
     console.error("[Server] Background indexing error:", err.message);
   });
 }

package/lib/config.js

@@ -57,7 +57,7 @@ const DEFAULT_CONFIG = {
   maxResults: 5,
   enableCache: true,
   cacheDirectory: "./.smart-coding-cache",
-  watchFiles: true,
+  watchFiles: false,
   verbose: false,
   embeddingModel: "Xenova/all-MiniLM-L6-v2",
   semanticWeight: 0.7,
@@ -187,6 +187,31 @@ export async function loadConfig(workspaceDir = null) {
     }
   }
   
+  if (process.env.SMART_CODING_WATCH_FILES !== undefined) {
+    const value = process.env.SMART_CODING_WATCH_FILES;
+    if (value === 'true' || value === 'false') {
+      config.watchFiles = value === 'true';
+    }
+  }
+  
+  if (process.env.SMART_CODING_SEMANTIC_WEIGHT !== undefined) {
+    const value = parseFloat(process.env.SMART_CODING_SEMANTIC_WEIGHT);
+    if (!isNaN(value) && value >= 0 && value <= 1) {
+      config.semanticWeight = value;
+    } else {
+      console.error(`[Config] Invalid SMART_CODING_SEMANTIC_WEIGHT: ${process.env.SMART_CODING_SEMANTIC_WEIGHT}, using default (must be 0-1)`);
+    }
+  }
+  
+  if (process.env.SMART_CODING_EXACT_MATCH_BOOST !== undefined) {
+    const value = parseFloat(process.env.SMART_CODING_EXACT_MATCH_BOOST);
+    if (!isNaN(value) && value >= 0) {
+      config.exactMatchBoost = value;
+    } else {
+      console.error(`[Config] Invalid SMART_CODING_EXACT_MATCH_BOOST: ${process.env.SMART_CODING_EXACT_MATCH_BOOST}, using default`);
+    }
+  }
+  
   return config;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-coding-mcp",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "An extensible MCP server that enhances coding productivity with AI-powered features including semantic code search, intelligent indexing, and more, using local LLMs",
   "type": "module",
   "main": "index.js",