smart-coding-mcp 1.0.1 → 1.2.0

package/README.md

@@ -30,36 +30,90 @@ This MCP server solves that by indexing your codebase with AI embeddings. Your A
 
 ## Installation
 
-### Prerequisites
+Install globally via npm:
 
-- Node.js 18 or higher
-- npm or yarn
+```bash
+npm install -g smart-coding-mcp
+```
 
-### Setup
+## Configuration
 
-1. Install dependencies:
+Add to your MCP configuration file (e.g., `~/.config/claude/mcp.json` or similar):
 
-```bash
-npm install
+### Option 1: Specific Project (Recommended)
+
+```json
+{
+  "mcpServers": {
+    "smart-coding-mcp": {
+      "command": "smart-coding-mcp",
+      "args": ["--workspace", "/absolute/path/to/your/project"]
+    }
+  }
+}
 ```
 
-2. Add to your MCP configuration file:
+### Option 2: Multi-Project Support
+
+```json
+{
+  "mcpServers": {
+    "smart-coding-mcp-project-a": {
+      "command": "smart-coding-mcp",
+      "args": ["--workspace", "/path/to/project-a"]
+    },
+    "smart-coding-mcp-project-b": {
+      "command": "smart-coding-mcp",
+      "args": ["--workspace", "/path/to/project-b"]
+    }
+  }
+}
+```
+
+### Option 3: Auto-Detect Current Directory
 
 ```json
 {
   "mcpServers": {
     "smart-coding-mcp": {
-      "command": "node",
-      "args": ["/path/to/smart-coding-mcp/index.js"],
-      "cwd": "/path/to/smart-coding-mcp"
+      "command": "smart-coding-mcp"
     }
   }
 }
 ```
 
-3. Restart your AI assistant
+## Environment Variables
+
+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 |
+
+**Example with environment variables:**
+
+```json
+{
+  "mcpServers": {
+    "smart-coding-mcp": {
+      "command": "smart-coding-mcp",
+      "args": ["--workspace", "/path/to/project"],
+      "env": {
+        "SMART_CODING_VERBOSE": "true",
+        "SMART_CODING_BATCH_SIZE": "200",
+        "SMART_CODING_MAX_FILE_SIZE": "2097152"
+      }
+    }
+  }
+}
+```
 
-The server will automatically index your codebase on first run.
+**Note**: The server starts instantly and indexes in the background, so your IDE won't be blocked waiting for indexing to complete.
 
 ## Available Tools
 
@@ -119,7 +173,7 @@ This typically reduces indexed file count by 100x. A project with 50,000 files (
 
 ## Configuration
 
-The server works out of the box with sensible defaults. Create a `config.json` file to customize:
+The server works out of the box with sensible defaults. Create a `config.json` file in your workspace to customize:
 
 ```json
 {
@@ -132,6 +186,8 @@ The server works out of the box with sensible defaults. Create a `config.json` f
   "cacheDirectory": "./.smart-coding-cache",
   "watchFiles": true,
   "chunkSize": 15,
+  "batchSize": 100,
+  "maxFileSize": 1048576,
   "maxResults": 5
 }
 ```
@@ -143,6 +199,8 @@ The server works out of the box with sensible defaults. Create a `config.json` f
 - `watchFiles`: Automatically reindex when files change (default: true)
 - `enableCache`: Cache embeddings to disk (default: true)
 - `chunkSize`: Lines of code per chunk - smaller = more precise, larger = more context (default: 15)
+- `batchSize`: Number of files to process in parallel (default: 100)
+- `maxFileSize`: Skip files larger than this size in bytes (default: 1MB)
 
 ## Examples
 

package/index.js

@@ -99,8 +99,11 @@ async function initialize() {
   features[1].instance = hybridSearch;
   features[2].instance = cacheClearer;
 
-  // Index codebase
-  await indexer.initialize();
+  // Start indexing in background (non-blocking)
+  console.error("[Server] Starting background indexing...");
+  indexer.initialize().catch(err => {
+    console.error("[Server] Background indexing error:", err.message);
+  });
 }
 
 // Setup MCP server

package/lib/config.js

@@ -136,6 +136,26 @@ export async function loadConfig(workspaceDir = null) {
     console.error(`[Config] Error: ${error.message}`);
   }
   
+  // Apply environment variable overrides (prefix: SMART_CODING_)
+  if (process.env.SMART_CODING_VERBOSE !== undefined) {
+    config.verbose = process.env.SMART_CODING_VERBOSE === 'true';
+  }
+  if (process.env.SMART_CODING_BATCH_SIZE !== undefined) {
+    config.batchSize = parseInt(process.env.SMART_CODING_BATCH_SIZE, 10);
+  }
+  if (process.env.SMART_CODING_MAX_FILE_SIZE !== undefined) {
+    config.maxFileSize = parseInt(process.env.SMART_CODING_MAX_FILE_SIZE, 10);
+  }
+  if (process.env.SMART_CODING_CHUNK_SIZE !== undefined) {
+    config.chunkSize = parseInt(process.env.SMART_CODING_CHUNK_SIZE, 10);
+  }
+  if (process.env.SMART_CODING_MAX_RESULTS !== undefined) {
+    config.maxResults = parseInt(process.env.SMART_CODING_MAX_RESULTS, 10);
+  }
+  if (process.env.SMART_CODING_SMART_INDEXING !== undefined) {
+    config.smartIndexing = process.env.SMART_CODING_SMART_INDEXING === 'true';
+  }
+  
   return config;
 }
 

package/package.json

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