@contextstream/mcp-server 0.3.3 → 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

@@ -6542,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.3"
+    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.3",
+  "version": "0.3.4",
   "description": "MCP server exposing ContextStream public API - code context, memory, search, and AI tools for developers",
   "type": "module",
   "license": "MIT",