@memly/mcp-server 0.2.6 → 0.2.8

package/dist/index.js

@@ -19967,7 +19967,7 @@ class MemlyClient {
 }
 
 // src/tools.ts
-function registerTools(server, client) {
+function registerTools(server, client, projectId) {
   server.tool("load_context", [
     "ALWAYS call this tool FIRST, before responding to any message in a new conversation.",
     "It loads your persistent memory from previous sessions so you can provide accurate, context-aware assistance.",
@@ -19977,7 +19977,7 @@ function registerTools(server, client) {
   }, async ({ topic }) => {
     try {
       const query = topic ?? "recent technical decisions architecture patterns current work";
-      const result = await client.searchMemories(query, undefined, 20);
+      const result = await client.searchMemories(query, projectId, 20);
       if (result.is_cold_start || result.memories.length === 0) {
         return {
           content: [{
@@ -20045,9 +20045,9 @@ Then answer normally. Use the memories above to inform your response.`
       };
     }
   });
-  server.tool("search_memories", "Search your stored memories semantically. Call this when you need to recall a specific previous decision, code pattern, or technical context that may not have been loaded by load_context.", {
+  server.tool("search_memories", "Search your stored memories semantically across ALL projects (cross-project by default). Call this when you need to recall a specific previous decision, code pattern, or technical context. Pass project_id to scope to a specific project.", {
     query: exports_external.string().min(1).describe("What to search for (natural language)"),
-    project_id: exports_external.string().uuid().optional().describe("Limit search to a specific project"),
+    project_id: exports_external.string().uuid().optional().describe("Scope to a specific project UUID. Omit to search across all projects."),
     limit: exports_external.number().int().min(1).max(20).optional().describe("Max results (default: 5)")
   }, async ({ query, project_id, limit }) => {
     try {
@@ -20085,7 +20085,7 @@ ${formatted}`
     project_id: exports_external.string().uuid().optional().describe("Associate with a specific project")
   }, async ({ content, project_id }) => {
     try {
-      await client.saveMemory(content, project_id, "user");
+      await client.saveMemory(content, project_id ?? projectId, "user");
       return {
         content: [{
           type: "text",
@@ -20250,6 +20250,7 @@ I am ready to continue our work.`
 import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { homedir, platform } from "node:os";
+import * as readline from "node:readline";
 var MEMLY_INSTRUCTION_BLOCK = `
 ## Memly — Persistent Memory (Auto-Enabled)
 
@@ -20269,6 +20270,30 @@ You have access to the Memly MCP server (\`memly\`).
 
 3. **Never** ask if you should remember something — just do it silently.
 `.trim();
+async function promptApiKey() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const isTTY = process.stdin.isTTY;
+  if (isTTY) {
+    rl.stdoutMuted = true;
+    const origWrite = rl._writeToOutput.bind(rl);
+    rl._writeToOutput = (str) => {
+      if (rl.stdoutMuted) {
+        process.stdout.write(str.replace(/[^\r\n]/g, "*"));
+      } else {
+        origWrite(str);
+      }
+    };
+  }
+  return new Promise((res) => {
+    rl.question("  Memly API key: ", (answer) => {
+      if (isTTY)
+        process.stdout.write(`
+`);
+      rl.close();
+      res(answer.trim());
+    });
+  });
+}
 async function validateApiKey(apiKey) {
   try {
     const controller = new AbortController;
@@ -20561,6 +20586,27 @@ function writeClaudeDesktop() {
     };
   }
 }
+async function resolveProjectId(apiKey, projectRoot) {
+  try {
+    const pkgPath = join(projectRoot, "package.json");
+    const fingerprint = existsSync(pkgPath) ? readFileSync(pkgPath, "utf-8").slice(0, 500) : `Project path: ${projectRoot}/src/index`;
+    const controller = new AbortController;
+    const timeout = setTimeout(() => controller.abort(), 8000);
+    const res = await fetch("https://api.memly.site/v1/chat/completions", {
+      method: "POST",
+      headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+      body: JSON.stringify({ model: "gpt-4.1-nano", stream: false, messages: [{ role: "user", content: fingerprint }] }),
+      signal: controller.signal
+    });
+    clearTimeout(timeout);
+    const id = res.headers.get("X-Memly-Project-Id");
+    if (id && /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id))
+      return id;
+    return null;
+  } catch {
+    return null;
+  }
+}
 async function reportTelemetry(results) {
   try {
     const controller = new AbortController;
@@ -20591,14 +20637,22 @@ async function runInit() {
   console.log("  Memly Init — Auto-Memory Setup");
   console.log(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 `);
-  const apiKey = process.env.MEMLY_API_KEY;
+  let apiKey = process.env.MEMLY_API_KEY;
+  let keyWasPrompted = false;
   if (!apiKey) {
-    console.error(`Error: MEMLY_API_KEY not set.
+    console.log(`No MEMLY_API_KEY found in environment.
 `);
-    console.error("Get your API key at: https://memly.site/dashboard");
-    console.error(`Then run: export MEMLY_API_KEY=memly_...
+    console.log(`  Get your key at: https://memly.site/dashboard
 `);
-    process.exit(1);
+    apiKey = await promptApiKey();
+    if (!apiKey) {
+      console.error(`
+No API key provided. Aborting.
+`);
+      process.exit(1);
+    }
+    process.env.MEMLY_API_KEY = apiKey;
+    keyWasPrompted = true;
   }
   process.stdout.write("Validating API key... ");
   const valid = await validateApiKey(apiKey);
@@ -20611,6 +20665,13 @@ async function runInit() {
   }
   console.log(`✓ Valid
 `);
+  if (keyWasPrompted) {
+    const isWin = process.platform === "win32";
+    const persistCmd = isWin ? '$env:MEMLY_API_KEY = "' + apiKey + '"' : 'export MEMLY_API_KEY="' + apiKey + '"';
+    console.log("  To persist this key, add to your shell profile:");
+    console.log(`    ${persistCmd}
+`);
+  }
   console.log(`Project: ${projectRoot}
 `);
   console.log(`Detecting IDEs...
@@ -20667,6 +20728,34 @@ async function runInit() {
   try {
     writeFileSync(join(projectRoot, ".memly-initialized"), new Date().toISOString());
   } catch {}
+  process.stdout.write(`
+Resolving project ID... `);
+  const projectId = await resolveProjectId(apiKey, projectRoot);
+  if (projectId) {
+    try {
+      writeFileSync(join(projectRoot, ".memly-project"), JSON.stringify({ project_id: projectId }, null, 2));
+      console.log(`✓ ${projectId}`);
+      const MARKER = `<!-- memly-project:${projectId} -->`;
+      const ideFiles = [
+        join(projectRoot, ".cursorrules"),
+        join(projectRoot, ".github", "copilot-instructions.md"),
+        join(projectRoot, ".clinerules"),
+        join(projectRoot, ".windsurfrules")
+      ];
+      for (const f of ideFiles) {
+        if (existsSync(f)) {
+          const content = readFileSync(f, "utf-8");
+          if (!content.includes(MARKER)) {
+            writeFileSync(f, content.trimEnd() + `
+` + MARKER + `
+`);
+          }
+        }
+      }
+    } catch {}
+  } else {
+    console.log("⊘ skipped (proxy unreachable — run init again after connecting)");
+  }
   await reportTelemetry(results);
   console.log(`
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -20683,6 +20772,8 @@ async function runInit() {
 }
 
 // src/index.ts
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { join as join2 } from "node:path";
 var apiKey = process.env.MEMLY_API_KEY;
 if (process.argv.includes("--init") || process.argv.includes("init")) {
   await runInit();
@@ -20696,6 +20787,21 @@ if (!apiKey) {
 var apiUrl = process.env.MEMLY_API_URL ?? "https://api.memly.site";
 var client = new MemlyClient(apiUrl, apiKey);
 var isHttp = process.argv.includes("--http");
+function readProjectId() {
+  if (process.env.MEMLY_PROJECT_ID)
+    return process.env.MEMLY_PROJECT_ID;
+  try {
+    const file = join2(process.cwd(), ".memly-project");
+    if (existsSync2(file)) {
+      const data = JSON.parse(readFileSync2(file, "utf-8"));
+      if (data.project_id && /^[0-9a-f-]{36}$/i.test(data.project_id)) {
+        return data.project_id;
+      }
+    }
+  } catch {}
+  return;
+}
+var projectId = readProjectId();
 if (isHttp) {
   const port = Number(process.env.MEMLY_PORT ?? 3800);
   const httpServer = Bun.serve({
@@ -20707,7 +20813,7 @@ if (isHttp) {
       }
       if (url.pathname === "/mcp") {
         const server = new McpServer({ name: "memly", version: "0.1.0" });
-        registerTools(server, client);
+        registerTools(server, client, projectId);
         registerResources(server, client);
         registerPrompts(server, client);
         const transport = new WebStandardStreamableHTTPServerTransport({
@@ -20724,7 +20830,7 @@ if (isHttp) {
   console.log(`   Health:   http://localhost:${httpServer.port}/health`);
 } else {
   const server = new McpServer({ name: "memly", version: "0.1.0" });
-  registerTools(server, client);
+  registerTools(server, client, projectId);
   registerResources(server, client);
   registerPrompts(server, client);
   const transport = new StdioServerTransport;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@memly/mcp-server",
-    "version": "0.2.6",
+    "version": "0.2.8",
     "description": "Memly MCP Server — persistent memory for any IDE",
     "type": "module",
     "main": "dist/index.js",
@@ -26,4 +26,4 @@
         "zod": "^3.24.2"
     },
     "license": "BSL-1.1"
-}
+}