memvid-mcp-server 1.0.3 → 1.0.5

package/README.md

@@ -23,9 +23,10 @@ This server can be used with any MCP-compliant client (e.g., Claude Desktop, Cur
 
 ### Environment Variables
 
-| Variable         | Description                                                                                              | Required      |
-| ---------------- | -------------------------------------------------------------------------------------------------------- | ------------- |
-| `OPENAI_API_KEY` | Your OpenAI API Key. Required to enable the `ask_memory` tool and for semantic embeddings in some modes. | No (Optional) |
+| Variable               | Description                                                                                              | Required      |
+| ---------------------- | -------------------------------------------------------------------------------------------------------- | ------------- |
+| `OPENAI_API_KEY`       | Your OpenAI API Key. Required to enable the `ask_memory` tool and for semantic embeddings in some modes. | No (Optional) |
+| `MEMVID_LOCAL_STORAGE` | Set to `"1"` to store memory files in `./memvid_mcp` (current directory) instead of `~/.memvid_mcp`.     | No (Optional) |
 
 ### Claude Desktop Configuration
 
@@ -38,7 +39,8 @@ Add the following to your `claude_desktop_config.json`:
       "command": "npx",
       "args": ["-y", "memvid-mcp-server"],
       "env": {
-        "OPENAI_API_KEY": "sk-..."
+        "OPENAI_API_KEY": "sk-...",
+        "MEMVID_LOCAL_STORAGE": "0"
       }
     }
   }
@@ -51,7 +53,7 @@ Add the following to your `claude_desktop_config.json`:
 
 1.  **`create_or_open_memory`**: Initialize a new project memory or open an existing one.
 2.  **`add_content`**: Add text and metadata to the memory.
-3.  **`search_memory`**: Search your memory.
+3.  **`search_memory`**: Search your memory. Use `query="*"` to list all recent items.
 4.  **`ask_memory`**: (Optional) Ask questions about your memory using an LLM.
 
 ## Development

package/dist/index.js

@@ -42,7 +42,12 @@ class MemoryManager {
   storageDir;
   constructor() {
     this.memories = new Map;
-    this.storageDir = path.join(os.homedir(), ".memvid_mcp");
+    if (process.env.MEMVID_LOCAL_STORAGE === "1") {
+      this.storageDir = path.join(process.cwd(), "memvid_mcp");
+      console.error(`[Memvid] Using local storage: ${this.storageDir}`);
+    } else {
+      this.storageDir = path.join(os.homedir(), ".memvid_mcp");
+    }
     this.ensureStorageDir();
   }
   static getInstance() {
@@ -144,15 +149,24 @@ function registerSearchMemory(server) {
   server.tool("search_memory", "Search for content in the project's memory using semantic search.", SearchMemorySchema.shape, async (args) => {
     const manager = MemoryManager.getInstance();
     const mem = await manager.getMemory(args.project_name);
-    const results = await mem.find(args.query, {
-      k: args.limit,
-      mode: args.mode
-    });
-    const hits = results.hits || [];
+    let results;
+    if (args.query === "*") {
+      if (typeof mem.timeline === "function") {
+        results = await mem.timeline({ k: args.limit });
+      } else {
+        results = await mem.find(undefined, { k: args.limit });
+      }
+    } else {
+      results = await mem.find(args.query, {
+        k: args.limit,
+        mode: args.mode
+      });
+    }
+    const hits = Array.isArray(results) ? results : results.hits || [];
     const formatted = hits.map((hit) => {
       return `[Title: ${hit.title || "Untitled"}]
-${hit.snippet || hit.text}
-(Score: ${hit.score})`;
+${hit.snippet || hit.text || hit.preview}
+(Score: ${hit.score || "N/A"})`;
     }).join(`
 
 ---

package/package.json

@@ -2,7 +2,7 @@
   "name": "memvid-mcp-server",
   "module": "index.ts",
   "description": "MCP Server for Memvid",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "logo": "https://memvid.io/logo.png",
   "keywords": [
     "mcp",