smart-context-mcp 1.0.0 → 1.0.2

package/README.md

@@ -27,6 +27,8 @@ 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.
+
 ## What you get
 
 Seven focused tools that work automatically:
@@ -217,6 +219,28 @@ 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):
+
+```bash
+MCP_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.
+
 ## What it is good at
 
 | Level | Languages / Stack | Use cases |

package/package.json

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

@@ -118,11 +118,14 @@ const writeFile = (filePath, content, dryRun) => {
   console.log(`updated ${filePath}`);
 };
 
-const getServerConfig = ({ name, command, args }) => ({
+const getServerConfig = ({ name, command, args, cwd }) => ({
   name,
   config: {
     command,
     args,
+    env: {
+      MCP_PROJECT_ROOT: cwd,
+    },
   },
 });
 
@@ -130,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);
 };
 
@@ -138,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);
 };
@@ -151,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);
 };
 
@@ -162,10 +183,17 @@ const buildCodexSection = (serverConfig) => {
     'required = false',
     `command = ${JSON.stringify(serverConfig.config.command)}`,
     `args = [${serverConfig.config.args.map((value) => JSON.stringify(value)).join(', ')}]`,
-    '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 };
 };
 
@@ -319,6 +347,7 @@ const main = () => {
     name: options.name,
     command: options.command,
     args,
+    cwd: targetDir,
   });
 
   const clientSet = new Set(options.clients);

package/src/mcp-server.js

@@ -1,3 +1,8 @@
+// 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);
+}
+
 import { runDevctxServer } from './server.js';
 
 await runDevctxServer();