smart-coding-mcp 1.2.0 → 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

@@ -4,6 +4,11 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { pipeline } from "@xenova/transformers";
 import fs from "fs/promises";
+import { createRequire } from "module";
+
+// Import package.json for version
+const require = createRequire(import.meta.url);
+const packageJson = require("./package.json");
 
 import { loadConfig } from "./lib/config.js";
 import { EmbeddingsCache } from "./lib/cache.js";
@@ -49,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,
@@ -94,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);
   });
 }
@@ -110,7 +120,7 @@ async function initialize() {
 const server = new Server(
   { 
     name: "smart-coding-mcp", 
-    version: "1.0.0" 
+    version: packageJson.version 
   },
   { 
     capabilities: { 

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,
@@ -136,24 +136,80 @@ export async function loadConfig(workspaceDir = null) {
     console.error(`[Config] Error: ${error.message}`);
   }
   
-  // Apply environment variable overrides (prefix: SMART_CODING_)
+  // Apply environment variable overrides (prefix: SMART_CODING_) with validation
   if (process.env.SMART_CODING_VERBOSE !== undefined) {
-    config.verbose = process.env.SMART_CODING_VERBOSE === 'true';
+    const value = process.env.SMART_CODING_VERBOSE;
+    if (value === 'true' || value === 'false') {
+      config.verbose = value === 'true';
+    }
   }
+  
   if (process.env.SMART_CODING_BATCH_SIZE !== undefined) {
-    config.batchSize = parseInt(process.env.SMART_CODING_BATCH_SIZE, 10);
+    const value = parseInt(process.env.SMART_CODING_BATCH_SIZE, 10);
+    if (!isNaN(value) && value > 0 && value <= 1000) {
+      config.batchSize = value;
+    } else {
+      console.error(`[Config] Invalid SMART_CODING_BATCH_SIZE: ${process.env.SMART_CODING_BATCH_SIZE}, using default`);
+    }
   }
+  
   if (process.env.SMART_CODING_MAX_FILE_SIZE !== undefined) {
-    config.maxFileSize = parseInt(process.env.SMART_CODING_MAX_FILE_SIZE, 10);
+    const value = parseInt(process.env.SMART_CODING_MAX_FILE_SIZE, 10);
+    if (!isNaN(value) && value > 0) {
+      config.maxFileSize = value;
+    } else {
+      console.error(`[Config] Invalid SMART_CODING_MAX_FILE_SIZE: ${process.env.SMART_CODING_MAX_FILE_SIZE}, using default`);
+    }
   }
+  
   if (process.env.SMART_CODING_CHUNK_SIZE !== undefined) {
-    config.chunkSize = parseInt(process.env.SMART_CODING_CHUNK_SIZE, 10);
+    const value = parseInt(process.env.SMART_CODING_CHUNK_SIZE, 10);
+    if (!isNaN(value) && value > 0 && value <= 100) {
+      config.chunkSize = value;
+    } else {
+      console.error(`[Config] Invalid SMART_CODING_CHUNK_SIZE: ${process.env.SMART_CODING_CHUNK_SIZE}, using default`);
+    }
   }
+  
   if (process.env.SMART_CODING_MAX_RESULTS !== undefined) {
-    config.maxResults = parseInt(process.env.SMART_CODING_MAX_RESULTS, 10);
+    const value = parseInt(process.env.SMART_CODING_MAX_RESULTS, 10);
+    if (!isNaN(value) && value > 0 && value <= 100) {
+      config.maxResults = value;
+    } else {
+      console.error(`[Config] Invalid SMART_CODING_MAX_RESULTS: ${process.env.SMART_CODING_MAX_RESULTS}, using default`);
+    }
   }
+  
   if (process.env.SMART_CODING_SMART_INDEXING !== undefined) {
-    config.smartIndexing = process.env.SMART_CODING_SMART_INDEXING === 'true';
+    const value = process.env.SMART_CODING_SMART_INDEXING;
+    if (value === 'true' || value === 'false') {
+      config.smartIndexing = value === 'true';
+    }
+  }
+  
+  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/lib/utils.js

@@ -31,14 +31,60 @@ export function smartChunk(content, file, config) {
   
   // Language-specific patterns for function/class detection
   const patterns = {
+    // JavaScript/TypeScript
     js: /^(export\s+)?(async\s+)?(function|class|const|let|var)\s+\w+/,
+    jsx: /^(export\s+)?(async\s+)?(function|class|const|let|var)\s+\w+/,
     ts: /^(export\s+)?(async\s+)?(function|class|const|let|var|interface|type)\s+\w+/,
-    py: /^(class|def)\s+\w+/,
-    java: /^(public|private|protected)?\s*(static\s+)?(class|interface|void|int|String|boolean)\s+\w+/,
-    go: /^func\s+\w+/,
-    rs: /^(pub\s+)?(fn|struct|enum|trait|impl)\s+\w+/,
+    tsx: /^(export\s+)?(async\s+)?(function|class|const|let|var|interface|type)\s+\w+/,
+    mjs: /^(export\s+)?(async\s+)?(function|class|const|let|var)\s+\w+/,
+    cjs: /^(export\s+)?(async\s+)?(function|class|const|let|var)\s+\w+/,
+    
+    // Python
+    py: /^(class|def|async\s+def)\s+\w+/,
+    pyw: /^(class|def|async\s+def)\s+\w+/,
+    
+    // Java/Kotlin/Scala
+    java: /^(public|private|protected)?\s*(static\s+)?(class|interface|enum|void|int|String|boolean)\s+\w+/,
+    kt: /^(class|interface|object|fun|val|var)\s+\w+/,
+    kts: /^(class|interface|object|fun|val|var)\s+\w+/,
+    scala: /^(class|object|trait|def|val|var)\s+\w+/,
+    
+    // C/C++
+    c: /^(struct|enum|union|void|int|char|float|double)\s+\w+/,
+    cpp: /^(class|struct|namespace|template|void|int|bool)\s+\w+/,
+    cc: /^(class|struct|namespace|template|void|int|bool)\s+\w+/,
+    cxx: /^(class|struct|namespace|template|void|int|bool)\s+\w+/,
+    h: /^(class|struct|namespace|template|void|int|bool)\s+\w+/,
+    hpp: /^(class|struct|namespace|template|void|int|bool)\s+\w+/,
+    
+    // C#
+    cs: /^(public|private|protected)?\s*(static\s+)?(class|interface|struct|enum|void|int|string|bool)\s+\w+/,
+    
+    // Go
+    go: /^(func|type|const|var)\s+\w+/,
+    
+    // Rust
+    rs: /^(pub\s+)?(fn|struct|enum|trait|impl|const|static)\s+\w+/,
+    
+    // PHP
+    php: /^(class|interface|trait|function|const)\s+\w+/,
+    
+    // Ruby
+    rb: /^(class|module|def)\s+\w+/,
+    rake: /^(class|module|def|task)\s+\w+/,
+    
+    // Swift
+    swift: /^(class|struct|enum|protocol|func|var|let)\s+\w+/,
+    
+    // R
+    r: /^(\w+)\s*<-\s*function/,
+    R: /^(\w+)\s*<-\s*function/,
+    
+    // Lua
+    lua: /^(function|local\s+function)\s+\w+/,
   };
 
+
   const langPattern = patterns[ext.slice(1)] || patterns.js;
   let currentChunk = [];
   let chunkStartLine = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-coding-mcp",
-  "version": "1.2.0",
+  "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",