@contextstream/mcp-server 0.4.7 → 0.4.9

package/dist/index.js

@@ -4051,8 +4051,9 @@ var coerce = {
 var NEVER = INVALID;
 
 // src/config.ts
+var DEFAULT_API_URL = "https://api.contextstream.io";
 var configSchema = external_exports.object({
-  apiUrl: external_exports.string().url(),
+  apiUrl: external_exports.string().url().default(DEFAULT_API_URL),
   apiKey: external_exports.string().min(1).optional(),
   jwt: external_exports.string().min(1).optional(),
   defaultWorkspaceId: external_exports.string().uuid().optional(),
@@ -4060,6 +4061,13 @@ var configSchema = external_exports.object({
   userAgent: external_exports.string().default("contextstream-mcp/0.1.0"),
   allowHeaderAuth: external_exports.boolean().optional()
 });
+var MISSING_CREDENTIALS_ERROR = "Set CONTEXTSTREAM_API_KEY or CONTEXTSTREAM_JWT for authentication (or CONTEXTSTREAM_ALLOW_HEADER_AUTH=true for header-based auth).";
+function isMissingCredentialsError(err) {
+  if (err instanceof Error) {
+    return err.message === MISSING_CREDENTIALS_ERROR;
+  }
+  return false;
+}
 function loadConfig() {
   const allowHeaderAuth = process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "1" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "true" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "yes";
   const parsed = configSchema.safeParse({
@@ -4078,7 +4086,7 @@ function loadConfig() {
     );
   }
   if (!parsed.data.apiKey && !parsed.data.jwt && !parsed.data.allowHeaderAuth) {
-    throw new Error("Set CONTEXTSTREAM_API_KEY or CONTEXTSTREAM_JWT for authentication (or CONTEXTSTREAM_ALLOW_HEADER_AUTH=true for header-based auth).");
+    throw new Error(MISSING_CREDENTIALS_ERROR);
   }
   return parsed.data;
 }
@@ -13485,6 +13493,40 @@ Each domain tool has an 'action' parameter for specific operations.` : "";
     console.error(`[ContextStream] Consolidated mode: Registered ${CONSOLIDATED_TOOLS.size} domain tools.`);
   }
 }
+function registerLimitedTools(server) {
+  server.registerTool(
+    "contextstream_setup",
+    {
+      title: "ContextStream Setup Required",
+      description: "ContextStream is not configured. Call this tool for setup instructions.",
+      inputSchema: { type: "object", properties: {} }
+    },
+    async () => {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `ContextStream: API key not configured.
+
+To set up (creates key + configures your editor):
+  npx -y @contextstream/mcp-server setup
+
+This will:
+- Start a 5-day Pro trial
+- Auto-configure your editor's MCP settings
+- Write rules files for better AI assistance
+
+Preview first:
+  npx -y @contextstream/mcp-server setup --dry-run
+
+After setup, restart your editor to enable all ContextStream tools.`
+          }
+        ]
+      };
+    }
+  );
+  console.error("[ContextStream] Limited mode: Registered setup helper tool only.");
+}
 
 // src/resources.ts
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -15180,6 +15222,7 @@ async function isEditorInstalled(editor) {
       return false;
   }
 }
+var IS_WINDOWS = process.platform === "win32";
 function buildContextStreamMcpServer(params) {
   const env = {
     CONTEXTSTREAM_API_URL: params.apiUrl,
@@ -15188,6 +15231,13 @@ function buildContextStreamMcpServer(params) {
   if (params.toolset === "router") {
     env.CONTEXTSTREAM_PROGRESSIVE_MODE = "true";
   }
+  if (IS_WINDOWS) {
+    return {
+      command: "cmd",
+      args: ["/c", "npx", "-y", "@contextstream/mcp-server"],
+      env
+    };
+  }
   return {
     command: "npx",
     args: ["-y", "@contextstream/mcp-server"],
@@ -15202,6 +15252,14 @@ function buildContextStreamVsCodeServer(params) {
   if (params.toolset === "router") {
     env.CONTEXTSTREAM_PROGRESSIVE_MODE = "true";
   }
+  if (IS_WINDOWS) {
+    return {
+      type: "stdio",
+      command: "cmd",
+      args: ["/c", "npx", "-y", "@contextstream/mcp-server"],
+      env
+    };
+  }
   return {
     type: "stdio",
     command: "npx",
@@ -15284,13 +15342,16 @@ async function upsertCodexTomlConfig(filePath, params) {
   const envMarker = "[mcp_servers.contextstream.env]";
   const toolsetLine = params.toolset === "router" ? `CONTEXTSTREAM_PROGRESSIVE_MODE = "true"
 ` : "";
+  const commandLine = IS_WINDOWS ? `command = "cmd"
+args = ["/c", "npx", "-y", "@contextstream/mcp-server"]
+` : `command = "npx"
+args = ["-y", "@contextstream/mcp-server"]
+`;
   const block = `
 
 # ContextStream MCP server
 [mcp_servers.contextstream]
-command = "npx"
-args = ["-y", "@contextstream/mcp-server"]
-
+` + commandLine + `
 [mcp_servers.contextstream.env]
 CONTEXTSTREAM_API_URL = "${params.apiUrl}"
 CONTEXTSTREAM_API_KEY = "${params.apiKey}"
@@ -15903,6 +15964,13 @@ Applying to ${projects.length} project(s)...`);
     if (toolset === "router") {
       console.log("- Router mode uses 2 meta-tools (session_init + context_smart) for ultra-minimal token usage.");
     }
+    console.log("");
+    console.log("You're set up! Now try these prompts in your AI tool:");
+    console.log('  1) "session summary"');
+    console.log(`  2) "remember we're using PostgreSQL"`);
+    console.log('  3) "what did we decide about auth?"');
+    console.log("");
+    console.log("More at: https://contextstream.io/docs/mcp");
   } finally {
     rl.close();
   }
@@ -15986,6 +16054,18 @@ Notes:
     set these env vars in the client's MCP server configuration.
   - The server communicates over stdio; logs are written to stderr.`);
 }
+async function runLimitedModeServer() {
+  const server = new McpServer2({
+    name: "contextstream-mcp",
+    version: VERSION
+  });
+  registerLimitedTools(server);
+  console.error(`ContextStream MCP server v${VERSION} (limited mode)`);
+  console.error('Run "npx -y @contextstream/mcp-server setup" to enable all tools.');
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("ContextStream MCP server connected (limited mode - setup required)");
+}
 async function main() {
   const args = process.argv.slice(2);
   if (args.includes("--help") || args.includes("-h")) {
@@ -16007,7 +16087,23 @@ async function main() {
     await runHttpGateway();
     return;
   }
-  const config = loadConfig();
+  if (!process.env.CONTEXTSTREAM_API_KEY && !process.env.CONTEXTSTREAM_JWT) {
+    const saved = await readSavedCredentials();
+    if (saved) {
+      process.env.CONTEXTSTREAM_API_URL = saved.api_url;
+      process.env.CONTEXTSTREAM_API_KEY = saved.api_key;
+    }
+  }
+  let config;
+  try {
+    config = loadConfig();
+  } catch (err) {
+    if (isMissingCredentialsError(err)) {
+      await runLimitedModeServer();
+      return;
+    }
+    throw err;
+  }
   const client = new ContextStreamClient(config);
   const server = new McpServer2({
     name: "contextstream-mcp",

package/dist/test-server.js

@@ -4051,8 +4051,9 @@ var coerce = {
 var NEVER = INVALID;
 
 // src/config.ts
+var DEFAULT_API_URL = "https://api.contextstream.io";
 var configSchema = external_exports.object({
-  apiUrl: external_exports.string().url(),
+  apiUrl: external_exports.string().url().default(DEFAULT_API_URL),
   apiKey: external_exports.string().min(1).optional(),
   jwt: external_exports.string().min(1).optional(),
   defaultWorkspaceId: external_exports.string().uuid().optional(),
@@ -4060,6 +4061,7 @@ var configSchema = external_exports.object({
   userAgent: external_exports.string().default("contextstream-mcp/0.1.0"),
   allowHeaderAuth: external_exports.boolean().optional()
 });
+var MISSING_CREDENTIALS_ERROR = "Set CONTEXTSTREAM_API_KEY or CONTEXTSTREAM_JWT for authentication (or CONTEXTSTREAM_ALLOW_HEADER_AUTH=true for header-based auth).";
 function loadConfig() {
   const allowHeaderAuth = process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "1" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "true" || process.env.CONTEXTSTREAM_ALLOW_HEADER_AUTH === "yes";
   const parsed = configSchema.safeParse({
@@ -4078,7 +4080,7 @@ function loadConfig() {
     );
   }
   if (!parsed.data.apiKey && !parsed.data.jwt && !parsed.data.allowHeaderAuth) {
-    throw new Error("Set CONTEXTSTREAM_API_KEY or CONTEXTSTREAM_JWT for authentication (or CONTEXTSTREAM_ALLOW_HEADER_AUTH=true for header-based auth).");
+    throw new Error(MISSING_CREDENTIALS_ERROR);
   }
   return parsed.data;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contextstream/mcp-server",
   "mcpName": "io.github.contextstreamio/mcp-server",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "ContextStream MCP server - v0.4.x with consolidated domain tools (~11 tools, ~75% token reduction). Code context, memory, search, and AI tools.",
   "type": "module",
   "license": "MIT",