smart-context-mcp 1.0.2 → 1.0.3

package/README.md

@@ -27,7 +27,7 @@ npx smart-context-init --target .
 
 That's it. Restart your AI client (Cursor, Codex, Claude Desktop) and the tools are available.
 
-**Important:** The init command automatically sets the correct `cwd` (working directory) in the generated configs, so the MCP server runs from your project root. This works for standalone projects, monorepos, and nested workspaces.
+**Important:** The init command automatically sets the correct project-root env var in the generated configs, so the MCP server runs from your project root. This works for standalone projects, monorepos, and nested workspaces.
 
 ## What you get
 
@@ -233,13 +233,15 @@ or:
 DEVCTX_PROJECT_ROOT=/path/to/target-repo node ./src/mcp-server.js
 ```
 
-or (recommended for MCP clients):
+or (recommended for MCP clients and generated configs):
 
 ```bash
-MCP_PROJECT_ROOT=/path/to/target-repo node ./src/mcp-server.js
+DEVCTX_PROJECT_ROOT=/path/to/target-repo node ./src/mcp-server.js
 ```
 
-`smart-context-init` automatically sets `MCP_PROJECT_ROOT` in the generated client configs (`.cursor/mcp.json`, `.codex/config.toml`, `.mcp.json`, `.qwen/settings.json`), so the MCP server always launches from the correct project context, even in monorepos or when installed globally.
+Legacy configs that still set `MCP_PROJECT_ROOT` remain supported for backward compatibility.
+
+`smart-context-init` automatically sets `DEVCTX_PROJECT_ROOT` in the generated client configs (`.cursor/mcp.json`, `.codex/config.toml`, `.mcp.json`, `.qwen/settings.json`), so the MCP server always launches from the correct project context, even in monorepos or when installed globally.
 
 ## What it is good at
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smart-context-mcp",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "MCP server that reduces agent token usage and improves response quality with compact file summaries, ranked code search, and curated context.",
   "author": "Francisco Caballero Portero <fcp1978@hotmail.com>",
   "type": "module",

package/scripts/init-clients.js

@@ -124,7 +124,7 @@ const getServerConfig = ({ name, command, args, cwd }) => ({
     command,
     args,
     env: {
-      MCP_PROJECT_ROOT: cwd,
+      DEVCTX_PROJECT_ROOT: cwd,
     },
   },
 });

package/scripts/report-metrics.js

@@ -11,7 +11,7 @@ const requireValue = (argv, index, flag) => {
   return value;
 };
 
-const parseArgs = (argv) => {
+export const parseArgs = (argv) => {
   const options = {
     file: null,
     json: false,
@@ -46,7 +46,7 @@ const parseArgs = (argv) => {
 
 const unique = (items) => [...new Set(items.filter(Boolean))];
 
-const resolveMetricsInput = (options) => {
+export const resolveMetricsInput = (options) => {
   if (options.file) {
     return { filePath: options.file, source: 'explicit' };
   }
@@ -66,7 +66,7 @@ const resolveMetricsInput = (options) => {
   return { filePath: defaultPath, source: 'default' };
 };
 
-const readEntries = (filePath) => {
+export const readEntries = (filePath) => {
   if (!fs.existsSync(filePath)) {
     throw new Error(`No metrics file found at ${filePath}`);
   }
@@ -100,7 +100,7 @@ const getSavedTokens = (entry, compressedTokens) => {
   return Math.max(0, Number(entry.rawTokens ?? 0) - compressedTokens);
 };
 
-const aggregate = (entries) => {
+export const aggregate = (entries) => {
   const byTool = new Map();
   let rawTokens = 0;
   let compressedTokens = 0;
@@ -148,6 +148,21 @@ const aggregate = (entries) => {
 
 const formatNumber = (value) => new Intl.NumberFormat('en-US').format(value);
 
+export const createReport = (options) => {
+  const resolved = resolveMetricsInput(options);
+  const { entries, invalidLines } = readEntries(resolved.filePath);
+  const filteredEntries = options.tool ? entries.filter((entry) => entry.tool === options.tool) : entries;
+  const summary = aggregate(filteredEntries);
+
+  return {
+    filePath: resolved.filePath,
+    source: resolved.source,
+    toolFilter: options.tool,
+    invalidLines,
+    summary,
+  };
+};
+
 const printHuman = (report) => {
   console.log('');
   console.log('devctx metrics report');
@@ -176,20 +191,9 @@ const printHuman = (report) => {
   }
 };
 
-const main = () => {
+export const main = () => {
   const options = parseArgs(process.argv.slice(2));
-  const resolved = resolveMetricsInput(options);
-  const { entries, invalidLines } = readEntries(resolved.filePath);
-  const filteredEntries = options.tool ? entries.filter((entry) => entry.tool === options.tool) : entries;
-  const summary = aggregate(filteredEntries);
-
-  const report = {
-    filePath: resolved.filePath,
-    source: resolved.source,
-    toolFilter: options.tool,
-    invalidLines,
-    summary,
-  };
+  const report = createReport(options);
 
   if (options.json) {
     process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);

package/src/mcp-server.js

@@ -1,6 +1,9 @@
-// Check if MCP_PROJECT_ROOT env var is set (passed by MCP clients via config)
-if (process.env.MCP_PROJECT_ROOT) {
-  process.chdir(process.env.MCP_PROJECT_ROOT);
+const configuredProjectRoot =
+  process.env.DEVCTX_PROJECT_ROOT?.trim() ||
+  process.env.MCP_PROJECT_ROOT?.trim();
+
+if (configuredProjectRoot) {
+  process.chdir(configuredProjectRoot);
 }
 
 import { runDevctxServer } from './server.js';

package/src/utils/runtime-config.js

@@ -14,10 +14,22 @@ const readArgValue = (name) => {
   return process.argv[index + 1] ?? null;
 };
 
+const readEnvValue = (...names) => {
+  for (const name of names) {
+    const value = process.env[name]?.trim();
+
+    if (value) {
+      return value;
+    }
+  }
+
+  return null;
+};
+
 const defaultDevctxRoot = path.resolve(currentDir, '..', '..');
 const defaultProjectRoot = path.resolve(defaultDevctxRoot, '..', '..');
 const projectRootArg = readArgValue('--project-root');
-const projectRootEnv = process.env.DEVCTX_PROJECT_ROOT ?? null;
+const projectRootEnv = readEnvValue('DEVCTX_PROJECT_ROOT', 'MCP_PROJECT_ROOT');
 const rawProjectRoot = projectRootArg ?? projectRootEnv ?? defaultProjectRoot;
 
 export const devctxRoot = defaultDevctxRoot;