feat(cli, config, install): enhance MCP server configuration with SUPAMEM_PROJECT_ROOT

- Updated cmd_mcp_server to accept SUPAMEM_PROJECT_ROOT environment variable for dynamic configuration loading.
- Enhanced config documentation to clarify the use of SUPAMEM_PROJECT_ROOT when launching the server outside the repository.
- Refactored MCP overlay in cursor.py to conditionally inject SUPAMEM_PROJECT_ROOT based on the presence of the config file in the current working directory.

Author: dzmitrys-dev

.cursor/hooks/state/continual-learning.json

@@ -0,0 +1,8 @@
+{
+  "version": 1,
+  "lastRunAtMs": 0,
+  "turnsSinceLastRun": 1,
+  "lastTranscriptMtimeMs": null,
+  "lastProcessedGenerationId": "32fae60f-1417-4a59-8650-e81412d14f7f",
+  "trialStartedAtMs": null
+}

src/supamem/cli.py

@@ -90,10 +90,16 @@ def cmd_mcp_server(
     host: str = typer.Option("127.0.0.1", "--host", help="HTTP bind host (only used when --transport http)."),
 ) -> None:
     """Run the dual-memory MCP server."""
+    import os
+
+    from pathlib import Path
+
     from supamem.config import load_config
     from supamem.mcp_server import run_http, run_stdio
 
-    cfg, _chain = load_config()
+    root = os.environ.get("SUPAMEM_PROJECT_ROOT", "").strip()
+    cfg_root = Path(root) if root else None
+    cfg, _chain = load_config(cfg_root)
     if transport is Transport.stdio:
         run_stdio(cfg)
     elif transport is Transport.http:

src/supamem/config.py

@@ -3,7 +3,9 @@
 Resolution order (highest to lowest):
 
 1. ``$SUPAMEM_CONFIG`` env var pointing to an explicit TOML file
-2. ``<cwd>/.supamem/config.toml`` (the canonical project config)
+2. ``<cwd>/.supamem/config.toml`` (the canonical project config).
+   MCP stdio defaults ``cwd`` to ``Path.cwd()``; set ``SUPAMEM_PROJECT_ROOT`` to your
+   workspace root when the host launches the server outside the repo (Cursor/IDE).
 3. ``<cwd>/pyproject.toml`` ``[tool.supamem]`` section
 4. Auto-detect: presence of ``<cwd>/.claude/insights/`` seeds ``sources``
 5. Defaults baked into ``ResolvedConfig``

src/supamem/install/cursor.py

@@ -24,15 +24,17 @@
 
 log = logging.getLogger("supamem.install.cursor")
 
-MCP_OVERLAY: dict[str, Any] = {
-    "mcpServers": {
-        "supamem": {
-            "command": "supamem",
-            "args": ["mcp-server", "--transport", "stdio"],
-            "env": {"DM_MCP_SOURCE": "mcp_cursor"},
-        }
+
+def _mcp_supamem_entry(cwd: Path) -> dict[str, Any]:
+    """Cursor MCP stanza — inject SUPAMEM_PROJECT_ROOT when bootstrapped in-repo."""
+    env: dict[str, str] = {"DM_MCP_SOURCE": "mcp_cursor"}
+    if (cwd / ".supamem" / "config.toml").is_file():
+        env["SUPAMEM_PROJECT_ROOT"] = str(cwd.resolve())
+    return {
+        "command": "supamem",
+        "args": ["mcp-server", "--transport", "stdio"],
+        "env": env,
     }
-}
 
 SESSION_START_HOOK: dict[str, Any] = {
     "sessionStart": [
@@ -90,7 +92,10 @@ def install(*, dry_run: bool = False) -> InstallResult:
     diffs: list[str] = []
 
     cur_mcp = _read_json(mcp_path)
-    merged_mcp = deep_merge_json(cur_mcp, MCP_OVERLAY)
+    merged_mcp = deep_merge_json(
+        cur_mcp,
+        {"mcpServers": {"supamem": _mcp_supamem_entry(cwd)}},
+    )
     res_mcp = atomic_write_json(mcp_path, merged_mcp, dry_run=dry_run)
     if res_mcp.diff:
         diffs.append(res_mcp.diff)