@contextstream/mcp-server 0.4.6 → 0.4.8

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;
 }
@@ -8581,7 +8589,7 @@ function estimateGraphIngestMinutes(stats) {
   };
 }
 function normalizeLessonField(value) {
-  return value.trim().toLowerCase().replace(/\s+/g, " ");
+  return (value || "").trim().toLowerCase().replace(/\s+/g, " ");
 }
 function buildLessonSignature(input, workspaceId, projectId) {
   return [
@@ -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";
@@ -15903,6 +15945,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 +16035,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 +16068,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.6",
+  "version": "0.4.8",
   "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",