smart-context-mcp 1.0.1 → 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
 
@@ -219,6 +219,30 @@ The `intent` parameter in `smart_search` and `smart_context` adjusts ranking and
 
 The rules are idempotent — running `smart-context-init` again updates the section without duplicating it. Existing content in `AGENTS.md` and `CLAUDE.md` is preserved.
 
+## Use against another repo
+
+By default, `devctx` works against the repo where it is installed. You can point it at another repo without modifying that target project:
+
+```bash
+node ./src/mcp-server.js --project-root /path/to/target-repo
+```
+
+or:
+
+```bash
+DEVCTX_PROJECT_ROOT=/path/to/target-repo node ./src/mcp-server.js
+```
+
+or (recommended for MCP clients and generated configs):
+
+```bash
+DEVCTX_PROJECT_ROOT=/path/to/target-repo node ./src/mcp-server.js
+```
+
+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
 
 | Level | Languages / Stack | Use cases |

package/package.json

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

@@ -123,7 +123,9 @@ const getServerConfig = ({ name, command, args, cwd }) => ({
   config: {
     command,
     args,
-    ...(cwd ? { cwd } : {}),
+    env: {
+      DEVCTX_PROJECT_ROOT: cwd,
+    },
   },
 });
 
@@ -131,7 +133,14 @@ const updateCursorConfig = (targetDir, serverConfig, dryRun) => {
   const filePath = path.join(targetDir, '.cursor', 'mcp.json');
   const current = readJson(filePath, { mcpServers: {} });
   current.mcpServers ??= {};
-  current.mcpServers[serverConfig.name] = serverConfig.config;
+  const existing = current.mcpServers[serverConfig.name] || {};
+  current.mcpServers[serverConfig.name] = {
+    ...serverConfig.config,
+    env: {
+      ...existing.env,
+      ...serverConfig.config.env,
+    },
+  };
   writeFile(filePath, `${JSON.stringify(current, null, 2)}\n`, dryRun);
 };
 
@@ -139,9 +148,13 @@ const updateClaudeConfig = (targetDir, serverConfig, dryRun) => {
   const filePath = path.join(targetDir, '.mcp.json');
   const current = readJson(filePath, { mcpServers: {} });
   current.mcpServers ??= {};
+  const existing = current.mcpServers[serverConfig.name] || {};
   current.mcpServers[serverConfig.name] = {
     ...serverConfig.config,
-    env: current.mcpServers[serverConfig.name]?.env ?? {},
+    env: {
+      ...existing.env,
+      ...serverConfig.config.env,
+    },
   };
   writeFile(filePath, `${JSON.stringify(current, null, 2)}\n`, dryRun);
 };
@@ -152,7 +165,14 @@ const updateQwenConfig = (targetDir, serverConfig, dryRun) => {
   current.mcp ??= {};
   current.mcp.enabled = true;
   current.mcpServers ??= {};
-  current.mcpServers[serverConfig.name] = serverConfig.config;
+  const existing = current.mcpServers[serverConfig.name] || {};
+  current.mcpServers[serverConfig.name] = {
+    ...serverConfig.config,
+    env: {
+      ...existing.env,
+      ...serverConfig.config.env,
+    },
+  };
   writeFile(filePath, `${JSON.stringify(current, null, 2)}\n`, dryRun);
 };
 
@@ -163,11 +183,17 @@ const buildCodexSection = (serverConfig) => {
     'required = false',
     `command = ${JSON.stringify(serverConfig.config.command)}`,
     `args = [${serverConfig.config.args.map((value) => JSON.stringify(value)).join(', ')}]`,
-    ...(serverConfig.config.cwd ? [`cwd = ${JSON.stringify(serverConfig.config.cwd)}`] : []),
-    'startup_timeout_sec = 15.0',
-    'tool_timeout_sec = 30.0',
   ];
 
+  if (serverConfig.config.env && Object.keys(serverConfig.config.env).length > 0) {
+    const envEntries = Object.entries(serverConfig.config.env)
+      .map(([key, value]) => `  ${JSON.stringify(key)} = ${JSON.stringify(value)}`)
+      .join(',\n');
+    body.push(`env = {\n${envEntries}\n}`);
+  }
+
+  body.push('startup_timeout_sec = 15.0', 'tool_timeout_sec = 30.0');
+
   return { header, body };
 };
 

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,3 +1,11 @@
+const configuredProjectRoot =
+  process.env.DEVCTX_PROJECT_ROOT?.trim() ||
+  process.env.MCP_PROJECT_ROOT?.trim();
+
+if (configuredProjectRoot) {
+  process.chdir(configuredProjectRoot);
+}
+
 import { runDevctxServer } from './server.js';
 
 await runDevctxServer();

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;