codedev-mcp 3.2.1 → 3.2.2

package/README.md

@@ -205,7 +205,8 @@ Add to `~/.gemini/settings.json`:
 > **Note**: If Gemini CLI can't find `npx`, use the full path: `"command": "/usr/local/bin/npx"` (run `which npx` to find yours). On Windows, use `npx.cmd` or the full path from `where npx`.
 
 ### Cursor
-Add to `~/.cursor/mcp.json`:
+
+**Recommended**: Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-specific):
 ```json
 {
   "mcpServers": {
@@ -217,6 +218,21 @@ Add to `~/.cursor/mcp.json`:
 }
 ```
 
+**Alternative** (if installed locally via `npm install codedev-mcp`):
+```json
+{
+  "mcpServers": {
+    "codedev": {
+      "command": "node",
+      "args": ["./node_modules/codedev-mcp/dist/index.js"],
+      "cwd": "${workspaceFolder}"
+    }
+  }
+}
+```
+
+> **Note**: Using `npx` is recommended because it works whether the package is installed locally or globally, and automatically resolves the correct path.
+
 ### VS Code / GitHub Copilot
 Command Palette → "MCP: Add Server", or add to `.vscode/settings.json`:
 ```json
@@ -269,17 +285,78 @@ Or with docker-compose:
 PROJECT_DIR=/path/to/project docker-compose up
 ```
 
-### Version Pinning
+### Installation Methods
+
+#### Method 1: Using npx (Recommended)
+`npx -y codedev-mcp` automatically downloads and runs the latest version. No installation needed:
+```json
+{
+  "mcpServers": {
+    "codedev": {
+      "command": "npx",
+      "args": ["-y", "codedev-mcp"]
+    }
+  }
+}
+```
+
+#### Method 2: Local Installation (Project-specific)
+Install in your project for version control:
+```bash
+npm install codedev-mcp
+```
+
+Then configure using `npx` (works with local installs too):
+```json
+{
+  "mcpServers": {
+    "codedev": {
+      "command": "npx",
+      "args": ["-y", "codedev-mcp"]
+    }
+  }
+}
+```
+
+Or reference directly (project-specific config):
+```json
+{
+  "mcpServers": {
+    "codedev": {
+      "command": "node",
+      "args": ["./node_modules/codedev-mcp/dist/index.js"],
+      "cwd": "${workspaceFolder}"
+    }
+  }
+}
+```
+
+#### Method 3: Global Installation
+Install globally for system-wide access:
+```bash
+npm install -g codedev-mcp
+```
 
-`npx -y codedev-mcp` always fetches the latest version. For stability in CI/CD or team environments, pin a version:
+Then configure:
+```json
+{
+  "mcpServers": {
+    "codedev": {
+      "command": "codedev-mcp"
+    }
+  }
+}
+```
 
+#### Version Pinning
+To pin a specific version with npx:
 ```bash
-npx -y codedev-mcp@3.1.0
+npx -y codedev-mcp@3.2.1
 ```
 
-Or install globally:
+Or install a specific version locally:
 ```bash
-npm install -g codedev-mcp@3.1.0
+npm install codedev-mcp@3.2.1
 ```
 
 ## Working Directory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codedev-mcp",
-  "version": "3.2.1",
+  "version": "3.2.2",
   "description": "Universal code development MCP server — search, analyze, navigate, review any codebase. 29 tools, semantic search, AST parsing, security scanning, dead code detection, complexity heatmaps, DB schema parsing, API discovery, IaC analysis, CI/CD parsing, monorepo support. Zero API keys.",
   "type": "module",
   "main": "dist/index.js",
@@ -9,6 +9,7 @@
   },
   "files": [
     "dist",
+    "scripts",
     "README.md",
     "LICENSE",
     "CHANGELOG.md",
@@ -20,6 +21,7 @@
     "start": "node dist/index.js",
     "inspect": "npx @modelcontextprotocol/inspector dist/index.js",
     "prepublishOnly": "npm run build && npm audit --audit-level=high",
+    "postinstall": "node scripts/postinstall.js",
     "test": "vitest",
     "test:coverage": "vitest run --coverage",
     "lint": "eslint \"src/**/*.{ts,tsx}\"",

package/scripts/postinstall.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script to help users configure codedev-mcp
+ */
+
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+
+console.log('\n✨ codedev-mcp installed successfully!\n');
+console.log('📝 Next step: Add to your MCP configuration file:\n');
+
+console.log('For Cursor (~/.cursor/mcp.json or .cursor/mcp.json):');
+console.log(JSON.stringify({
+  mcpServers: {
+    codedev: {
+      command: 'npx',
+      args: ['-y', 'codedev-mcp'],
+    },
+  },
+}, null, 2));
+
+console.log('\nFor Claude Desktop (claude_desktop_config.json):');
+console.log(JSON.stringify({
+  mcpServers: {
+    codedev: {
+      command: 'npx',
+      args: ['-y', 'codedev-mcp'],
+    },
+  },
+}, null, 2));
+
+console.log('\n💡 Tip: Using `npx` works for both local and global installations.');
+console.log('📚 Full documentation: https://github.com/Kranthithota/codedev-mcp\n');