@contextstream/mcp-server 0.3.2 → 0.3.4

package/README.md

@@ -54,6 +54,22 @@ Add ContextStream to your AI tool's MCP configuration (works with **Cursor**, **
 
 Get your API key at [contextstream.io](https://contextstream.io)
 
+### Codex (CLI) configuration
+
+For the Codex CLI, add the MCP server to your `~/.codex/config.toml`:
+
+```toml
+[mcpServers.contextstream]
+command = "npx"
+args = ["-y", "@contextstream/mcp-server"]
+
+[mcpServers.contextstream.env]
+CONTEXTSTREAM_API_URL = "https://api.contextstream.io"
+CONTEXTSTREAM_API_KEY = "your_api_key"
+```
+
+After saving the file, restart Codex. The ContextStream tools and auto-context will then be available in any trusted project that has a `.contextstream/config.json` (or a matching parent mapping in `~/.contextstream-mappings.json`).
+
 ## ✨ Auto-Context (v0.3.0+)
 
 Context loads **automatically** on the first tool call of any conversation. No need to manually call `session_init` — your AI assistant gets workspace info, recent memory, and decisions immediately.

package/dist/index.js

@@ -6379,16 +6379,47 @@ var SessionManager = class {
       return null;
     }
     try {
-      const rootsResponse = await this.server.server.listRoots();
-      console.error("[ContextStream] listRoots response:", JSON.stringify(rootsResponse));
-      if (rootsResponse?.roots) {
-        this.ideRoots = rootsResponse.roots.map(
-          (r) => r.uri.replace("file://", "")
-        );
-        console.error("[ContextStream] IDE roots detected:", this.ideRoots);
+      const capabilities = this.server.server.getClientCapabilities();
+      console.error("[ContextStream] Client capabilities:", JSON.stringify(capabilities));
+      if (capabilities?.roots) {
+        const rootsResponse = await this.server.server.listRoots();
+        console.error("[ContextStream] listRoots response:", JSON.stringify(rootsResponse));
+        if (rootsResponse?.roots) {
+          this.ideRoots = rootsResponse.roots.map(
+            (r) => r.uri.replace("file://", "")
+          );
+          console.error("[ContextStream] IDE roots detected via listRoots:", this.ideRoots);
+        }
+      } else {
+        console.error("[ContextStream] Client does not support roots capability");
       }
     } catch (e) {
-      console.error("[ContextStream] listRoots not available:", e?.message || e);
+      console.error("[ContextStream] listRoots failed:", e?.message || e);
+    }
+    if (this.ideRoots.length === 0) {
+      const envWorkspace = process.env.WORKSPACE_FOLDER || process.env.VSCODE_WORKSPACE_FOLDER || process.env.PROJECT_DIR || process.env.PWD;
+      if (envWorkspace && envWorkspace !== process.env.HOME) {
+        console.error("[ContextStream] Using workspace from env:", envWorkspace);
+        this.ideRoots = [envWorkspace];
+      }
+    }
+    if (this.ideRoots.length === 0) {
+      const cwd = process.cwd();
+      const fs3 = await import("fs");
+      const projectIndicators = [".git", "package.json", "Cargo.toml", "pyproject.toml", ".contextstream"];
+      const hasProjectIndicator = projectIndicators.some((f) => {
+        try {
+          return fs3.existsSync(`${cwd}/${f}`);
+        } catch {
+          return false;
+        }
+      });
+      if (hasProjectIndicator) {
+        console.error("[ContextStream] Using cwd as workspace:", cwd);
+        this.ideRoots = [cwd];
+      } else {
+        console.error("[ContextStream] cwd does not look like a project:", cwd);
+      }
     }
     if (this.ideRoots.length === 0 && this.folderPath) {
       this.ideRoots = [this.folderPath];
@@ -6491,13 +6522,15 @@ var SessionManager = class {
         parts.push(`   \u2022 [${type}] ${title}`);
       });
     }
+    parts.push("");
     if (context.ide_roots && context.ide_roots.length > 0) {
       const roots = context.ide_roots;
-      parts.push("");
       parts.push(`\u{1F5A5}\uFE0F  IDE Roots: ${roots.join(", ")}`);
     } else {
-      parts.push("");
-      parts.push(`\u{1F5A5}\uFE0F  IDE Roots: (none detected - used fallback)`);
+      parts.push(`\u{1F5A5}\uFE0F  IDE Roots: (none detected)`);
+    }
+    if (this.ideRoots.length > 0) {
+      parts.push(`   Detection: ${this.ideRoots[0]}`);
     }
     parts.push("");
     parts.push("\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550");
@@ -6509,12 +6542,46 @@ var SessionManager = class {
 };
 
 // src/index.ts
+var VERSION = "0.3.4";
+function printHelp() {
+  console.log(`ContextStream MCP Server (contextstream-mcp) v${VERSION}
+
+Usage:
+  npx -y @contextstream/mcp-server
+  contextstream-mcp
+
+Environment variables:
+  CONTEXTSTREAM_API_URL   Base API URL (e.g. https://api.contextstream.io)
+  CONTEXTSTREAM_API_KEY   API key for authentication (or use CONTEXTSTREAM_JWT)
+  CONTEXTSTREAM_JWT       JWT for authentication (alternative to API key)
+  CONTEXTSTREAM_WORKSPACE_ID  Optional default workspace ID
+  CONTEXTSTREAM_PROJECT_ID    Optional default project ID
+
+Examples:
+  CONTEXTSTREAM_API_URL="https://api.contextstream.io" \\
+  CONTEXTSTREAM_API_KEY="your_api_key" \\
+  npx -y @contextstream/mcp-server
+
+Notes:
+  - When used from an MCP client (e.g. Codex, Cursor, VS Code),
+    set these env vars in the client's MCP server configuration.
+  - The server communicates over stdio; logs are written to stderr.`);
+}
 async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    return;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    console.log(`contextstream-mcp v${VERSION}`);
+    return;
+  }
   const config = loadConfig();
   const client = new ContextStreamClient(config);
   const server = new McpServer({
     name: "contextstream-mcp",
-    version: "0.3.2"
+    version: VERSION
   });
   const sessionManager = new SessionManager(server, client);
   registerTools(server, client, sessionManager);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contextstream/mcp-server",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",