superlocalmemory 3.6.6__tar.gz → 3.6.7__tar.gz

{superlocalmemory-3.6.6/src/superlocalmemory.egg-info → superlocalmemory-3.6.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.6.6
+Version: 3.6.7
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -401,6 +401,32 @@ slm status
 
 ### MCP Integration (Claude, Cursor, Windsurf, VS Code, etc.)
 
+SLM supports **two MCP transports** — use whichever fits your tool. Both expose the same 33 tools and 7 resources.
+
+#### Option A — HTTP transport (v3.6.7+, recommended)
+
+One shared process handles every client. RAM is flat regardless of how many IDE windows, subagents, or concurrent sessions connect. Requires the SLM daemon to be running (`slm start`).
+
+```json
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "type": "http",
+      "url": "http://127.0.0.1:8765/mcp/"
+    }
+  }
+}
+```
+
+> **Claude Code** also accepts:
+> ```bash
+> claude mcp add --transport http superlocalmemory http://127.0.0.1:8765/mcp/
+> ```
+
+#### Option B — stdio transport (universal, works everywhere)
+
+Spawns one `slm mcp` subprocess per client connection (~90–110 MB each). Works with every MCP-compatible tool including those that do not yet support HTTP transport. No daemon required.
+
 ```json
 {
   "mcpServers": {
@@ -412,7 +438,36 @@ slm status
 }
 ```
 
-33 MCP tools by default (+42 optional behind `SLM_MCP_ALL_TOOLS=1`) + 7 resources. Works with any MCP-compatible client — we ship templated configs for Claude Code, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and Antigravity (15 IDE configs in `ide/configs/`). **V3.3: Adaptive lifecycle, smart compression, and pattern learning.**
+#### Option C — `mcp-remote` bridge (for stdio-only tools that want HTTP)
+
+Some CLIs (e.g. Grok CLI) only speak stdio but you still want the RAM benefit of HTTP. The [`@modelcontextprotocol/client-cli`](https://www.npmjs.com/package/@modelcontextprotocol/client-cli) package bridges them:
+
+```bash
+npm install -g @modelcontextprotocol/client-cli
+```
+
+```json
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "command": "mcp-remote",
+      "args": ["http://127.0.0.1:8765/mcp/", "--allow-http", "--transport", "http-only"]
+    }
+  }
+}
+```
+
+#### When to use which
+
+| Situation | Use |
+|-----------|-----|
+| Claude Code / Claude Desktop (v3.6.7+) | **HTTP** — zero new processes per session |
+| Cursor, Windsurf, Gemini CLI, Antigravity | **HTTP** — native support |
+| Grok CLI, tools that only support stdio | **`mcp-remote` bridge** |
+| Offline / daemon-free usage | **stdio** |
+| Any tool, any version | **stdio** always works as fallback |
+
+See [`docs/ide-setup.md`](docs/ide-setup.md) for per-IDE configs. 33 MCP tools by default (+42 optional behind `SLM_MCP_ALL_TOOLS=1`) + 7 resources. Works with any MCP-compatible client — we ship templated configs for Claude Code, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and Antigravity (15 IDE configs in `ide/configs/`).
 
 ### Dual Interface: MCP + CLI
 

{superlocalmemory-3.6.6 → superlocalmemory-3.6.7}/README.md

@@ -309,6 +309,32 @@ slm status
 
 ### MCP Integration (Claude, Cursor, Windsurf, VS Code, etc.)
 
+SLM supports **two MCP transports** — use whichever fits your tool. Both expose the same 33 tools and 7 resources.
+
+#### Option A — HTTP transport (v3.6.7+, recommended)
+
+One shared process handles every client. RAM is flat regardless of how many IDE windows, subagents, or concurrent sessions connect. Requires the SLM daemon to be running (`slm start`).
+
+```json
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "type": "http",
+      "url": "http://127.0.0.1:8765/mcp/"
+    }
+  }
+}
+```
+
+> **Claude Code** also accepts:
+> ```bash
+> claude mcp add --transport http superlocalmemory http://127.0.0.1:8765/mcp/
+> ```
+
+#### Option B — stdio transport (universal, works everywhere)
+
+Spawns one `slm mcp` subprocess per client connection (~90–110 MB each). Works with every MCP-compatible tool including those that do not yet support HTTP transport. No daemon required.
+
 ```json
 {
   "mcpServers": {
@@ -320,7 +346,36 @@ slm status
 }
 ```
 
-33 MCP tools by default (+42 optional behind `SLM_MCP_ALL_TOOLS=1`) + 7 resources. Works with any MCP-compatible client — we ship templated configs for Claude Code, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and Antigravity (15 IDE configs in `ide/configs/`). **V3.3: Adaptive lifecycle, smart compression, and pattern learning.**
+#### Option C — `mcp-remote` bridge (for stdio-only tools that want HTTP)
+
+Some CLIs (e.g. Grok CLI) only speak stdio but you still want the RAM benefit of HTTP. The [`@modelcontextprotocol/client-cli`](https://www.npmjs.com/package/@modelcontextprotocol/client-cli) package bridges them:
+
+```bash
+npm install -g @modelcontextprotocol/client-cli
+```
+
+```json
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "command": "mcp-remote",
+      "args": ["http://127.0.0.1:8765/mcp/", "--allow-http", "--transport", "http-only"]
+    }
+  }
+}
+```
+
+#### When to use which
+
+| Situation | Use |
+|-----------|-----|
+| Claude Code / Claude Desktop (v3.6.7+) | **HTTP** — zero new processes per session |
+| Cursor, Windsurf, Gemini CLI, Antigravity | **HTTP** — native support |
+| Grok CLI, tools that only support stdio | **`mcp-remote` bridge** |
+| Offline / daemon-free usage | **stdio** |
+| Any tool, any version | **stdio** always works as fallback |
+
+See [`docs/ide-setup.md`](docs/ide-setup.md) for per-IDE configs. 33 MCP tools by default (+42 optional behind `SLM_MCP_ALL_TOOLS=1`) + 7 resources. Works with any MCP-compatible client — we ship templated configs for Claude Code, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and Antigravity (15 IDE configs in `ide/configs/`).
 
 ### Dual Interface: MCP + CLI
 

{superlocalmemory-3.6.6 → superlocalmemory-3.6.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "3.6.6"
+version = "3.6.7"
 description = "Information-geometric agent memory with mathematical guarantees"
 readme = "README.md"
 license = {text = "AGPL-3.0-or-later"}

{superlocalmemory-3.6.6 → superlocalmemory-3.6.7}/src/superlocalmemory/__init__.py

@@ -28,7 +28,7 @@ if "OMP_NUM_THREADS" not in os.environ:
     os.environ["OMP_NUM_THREADS"] = "2"
 # ---------------------------------------------------------------------------
 
-__version__ = "3.6.6"
+__version__ = "3.6.7"
 
 _REQUIRED_VERSIONS = {
     "sentence_transformers": "5.3.0",

{superlocalmemory-3.6.6 → superlocalmemory-3.6.7}/src/superlocalmemory/mcp/server.py

@@ -237,8 +237,19 @@ def _eager_warmup() -> None:
         _logger.warning("Mesh auto-register failed: %s", exc)
 
 import threading
-_warmup_thread = threading.Thread(target=_eager_warmup, daemon=True, name="mcp-warmup")
-_warmup_thread.start()
+
+# v3.6.7: Suppress standalone-process behaviours when the MCP server is
+# imported inside the daemon (SLM_MCP_EMBEDDED=1). Three threads are safe
+# to run in a dedicated `slm mcp` subprocess but harmful inside the daemon:
+#   mcp-warmup      — creates a LIGHT engine duplicate; daemon has a FULL one.
+#   parent-watchdog — calls os._exit(0) if its parent IDE quits, which would
+#                     kill the daemon along with it.
+#   stdin-eof-monitor — monitors stdin pipe; meaningless inside the daemon.
+_embedded_in_daemon = _os.environ.get("SLM_MCP_EMBEDDED") == "1"
+
+if not _embedded_in_daemon:
+    _warmup_thread = threading.Thread(target=_eager_warmup, daemon=True, name="mcp-warmup")
+    _warmup_thread.start()
 
 
 # V3.4.57: Parent watchdog — self-terminate when the IDE/Claude session dies.
@@ -274,8 +285,9 @@ def _parent_watchdog() -> None:
             pass  # Transient errors — keep watching
 
 
-_watchdog_thread = threading.Thread(target=_parent_watchdog, daemon=True, name="parent-watchdog")
-_watchdog_thread.start()
+if not _embedded_in_daemon:
+    _watchdog_thread = threading.Thread(target=_parent_watchdog, daemon=True, name="parent-watchdog")
+    _watchdog_thread.start()
 
 
 # V3.5.9: Stdin EOF monitor — complements the parent watchdog for the case where
@@ -337,8 +349,9 @@ def _stdin_eof_monitor() -> None:
         _mlog.debug("stdin EOF monitor error: %s — watchdog will cover", exc)
 
 
-_stdin_monitor_thread = threading.Thread(target=_stdin_eof_monitor, daemon=True, name="stdin-eof-monitor")
-_stdin_monitor_thread.start()
+if not _embedded_in_daemon:
+    _stdin_monitor_thread = threading.Thread(target=_stdin_eof_monitor, daemon=True, name="stdin-eof-monitor")
+    _stdin_monitor_thread.start()
 
 
 if __name__ == "__main__":

{superlocalmemory-3.6.6 → superlocalmemory-3.6.7}/src/superlocalmemory/server/unified_daemon.py

@@ -34,11 +34,17 @@ import signal
 import sys
 import threading
 import time
-from contextlib import asynccontextmanager
+from contextlib import asynccontextmanager, AsyncExitStack
 from datetime import datetime, timezone
 from pathlib import Path
 from typing import Optional
 
+# v3.6.7: Tell mcp/server.py it is being imported inside the daemon process.
+# This suppresses the three side-effect threads (mcp-warmup, parent-watchdog,
+# stdin-eof-monitor) that are harmful when the MCP server runs embedded.
+# Must be set BEFORE any import of superlocalmemory.mcp.server.
+os.environ.setdefault("SLM_MCP_EMBEDDED", "1")
+
 from fastapi import FastAPI, HTTPException, Request
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.middleware.gzip import GZipMiddleware
@@ -850,7 +856,20 @@ async def lifespan(application: FastAPI):
     except Exception as e:
         logger.warning("optimize module not available: %s", e)
 
-    yield
+    # v3.6.7: Start MCP Streamable-HTTP session manager (GOTCHA #1).
+    # streamable_http_app() carries its own Starlette lifespan that initialises
+    # an anyio task group inside the session manager. Without entering that
+    # lifespan every POST /mcp 500s with "Task group is not initialized."
+    # AsyncExitStack enters the context only when _mcp_app was mounted; if the
+    # mount failed (non-fatal) the daemon starts normally without HTTP MCP.
+    async with AsyncExitStack() as _mcp_stack:
+        if _mcp_app is not None:
+            await _mcp_stack.enter_async_context(
+                _mcp_app.router.lifespan_context(_mcp_app)
+            )
+            logger.info("MCP HTTP session manager started (Streamable-HTTP on /mcp)")
+
+        yield
 
     # Cancel optimize metrics flush loop + run final flush before shutdown
     try:
@@ -1149,6 +1168,28 @@ def create_app() -> FastAPI:
     # -- Daemon-specific routes --
     _register_daemon_routes(application)
 
+    # -- v3.6.7: MCP Streamable-HTTP transport at /mcp --
+    # Mount the FastMCP server as a Starlette ASGI sub-app so ALL clients
+    # (Claude Code sessions, subagents, desktop, hermes) share ONE daemon
+    # process instead of spawning an `slm mcp` subprocess per connection.
+    # The session manager lifespan is started in lifespan() via AsyncExitStack.
+    # Fail-open: if import or mount fails, stdio transport keeps working.
+    #
+    # streamable_http_path is set to "/" so that when mounted at "/mcp" the
+    # effective user-facing endpoint is exactly http://127.0.0.1:8765/mcp.
+    # (FastAPI strips the mount prefix before passing the request to the
+    # sub-app, so the sub-app's internal route must be "/".)
+    try:
+        from superlocalmemory.mcp.server import server as _mcp_fastmcp
+        _mcp_fastmcp.settings.streamable_http_path = "/"
+        _mcp_fastmcp._session_manager = None  # Defensive reset for idempotency
+        global _mcp_app
+        _mcp_app = _mcp_fastmcp.streamable_http_app()
+        application.mount("/mcp", _mcp_app)
+        logger.info("MCP HTTP transport mounted at /mcp (Streamable HTTP, port 8765)")
+    except Exception as _mcp_exc:  # pragma: no cover — defensive
+        logger.warning("MCP HTTP mount failed (non-fatal, stdio still works): %s", _mcp_exc)
+
     return application
 
 
@@ -1202,7 +1243,9 @@ def _register_dashboard_routes(application: FastAPI) -> None:
         # for Gemini), never X-SLM-API-Key. Verified: auth_middleware.py:50-82
         # returns False for POST when api_key file exists and X-SLM-API-Key
         # is absent.
-        _AUTH_EXEMPT_PREFIXES = ("/v1/", "/v1beta/")
+        # v3.6.7: /mcp is also exempt — MCP clients negotiate their own session
+        # via the MCP protocol; they have no knowledge of X-SLM-API-Key.
+        _AUTH_EXEMPT_PREFIXES = ("/v1/", "/v1beta/", "/mcp")
 
         @application.middleware("http")
         async def auth_middleware(request, call_next):
@@ -1820,6 +1863,10 @@ def _update_activity():
 
 _start_time: float | None = None
 
+# v3.6.7: Starlette app returned by mcp_server.streamable_http_app().
+# Set in create_app(); consumed by lifespan() to start the session manager.
+_mcp_app = None
+
 
 # ---------------------------------------------------------------------------
 # Server entry point

{superlocalmemory-3.6.6 → superlocalmemory-3.6.7/src/superlocalmemory.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.6.6
+Version: 3.6.7
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -401,6 +401,32 @@ slm status
 
 ### MCP Integration (Claude, Cursor, Windsurf, VS Code, etc.)
 
+SLM supports **two MCP transports** — use whichever fits your tool. Both expose the same 33 tools and 7 resources.
+
+#### Option A — HTTP transport (v3.6.7+, recommended)
+
+One shared process handles every client. RAM is flat regardless of how many IDE windows, subagents, or concurrent sessions connect. Requires the SLM daemon to be running (`slm start`).
+
+```json
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "type": "http",
+      "url": "http://127.0.0.1:8765/mcp/"
+    }
+  }
+}
+```
+
+> **Claude Code** also accepts:
+> ```bash
+> claude mcp add --transport http superlocalmemory http://127.0.0.1:8765/mcp/
+> ```
+
+#### Option B — stdio transport (universal, works everywhere)
+
+Spawns one `slm mcp` subprocess per client connection (~90–110 MB each). Works with every MCP-compatible tool including those that do not yet support HTTP transport. No daemon required.
+
 ```json
 {
   "mcpServers": {
@@ -412,7 +438,36 @@ slm status
 }
 ```
 
-33 MCP tools by default (+42 optional behind `SLM_MCP_ALL_TOOLS=1`) + 7 resources. Works with any MCP-compatible client — we ship templated configs for Claude Code, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and Antigravity (15 IDE configs in `ide/configs/`). **V3.3: Adaptive lifecycle, smart compression, and pattern learning.**
+#### Option C — `mcp-remote` bridge (for stdio-only tools that want HTTP)
+
+Some CLIs (e.g. Grok CLI) only speak stdio but you still want the RAM benefit of HTTP. The [`@modelcontextprotocol/client-cli`](https://www.npmjs.com/package/@modelcontextprotocol/client-cli) package bridges them:
+
+```bash
+npm install -g @modelcontextprotocol/client-cli
+```
+
+```json
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "command": "mcp-remote",
+      "args": ["http://127.0.0.1:8765/mcp/", "--allow-http", "--transport", "http-only"]
+    }
+  }
+}
+```
+
+#### When to use which
+
+| Situation | Use |
+|-----------|-----|
+| Claude Code / Claude Desktop (v3.6.7+) | **HTTP** — zero new processes per session |
+| Cursor, Windsurf, Gemini CLI, Antigravity | **HTTP** — native support |
+| Grok CLI, tools that only support stdio | **`mcp-remote` bridge** |
+| Offline / daemon-free usage | **stdio** |
+| Any tool, any version | **stdio** always works as fallback |
+
+See [`docs/ide-setup.md`](docs/ide-setup.md) for per-IDE configs. 33 MCP tools by default (+42 optional behind `SLM_MCP_ALL_TOOLS=1`) + 7 resources. Works with any MCP-compatible client — we ship templated configs for Claude Code, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and Antigravity (15 IDE configs in `ide/configs/`).
 
 ### Dual Interface: MCP + CLI