@shodh/memory-mcp 0.1.1 → 0.1.4

package/README.md

@@ -1,86 +1,57 @@
-# Shodh-Memory MCP Server
-
-Persistent AI memory with semantic search. Store observations, decisions, learnings, and recall them across sessions.
-
-## Features
-
-- **Semantic Search**: Find memories by meaning, not just keywords
-- **Memory Types**: Categorize as Observation, Decision, Learning, Error, Pattern, etc.
-- **Persistent**: Memories survive across sessions and restarts
-- **Fast**: Sub-millisecond retrieval with vector indexing
-
-## Installation
-
-### 1. Start the shodh-memory backend
-
-```bash
-# Download and run the server
-cargo install shodh-memory
-shodh-memory-server
-```
-
-Or with Docker:
-```bash
-docker run -p 3030:3030 shodh/memory
-```
-
-### 2. Configure your MCP client
-
-**For Claude Desktop** (`~/.claude/claude_desktop_config.json`):
-```json
-{
-  "mcpServers": {
-    "shodh-memory": {
-      "command": "npx",
-      "args": ["@shodh/memory-mcp"],
-      "env": {
-        "SHODH_API_URL": "http://127.0.0.1:3030"
-      }
-    }
-  }
-}
-```
-
-**For Cursor/other MCP clients**: Similar configuration with the npx command.
-
-## Tools
-
-| Tool | Description |
-|------|-------------|
-| `remember` | Store a memory with optional type and tags |
-| `recall` | Semantic search to find relevant memories |
-| `context_summary` | Get categorized context for session bootstrap |
-| `list_memories` | List all stored memories |
-| `forget` | Delete a specific memory by ID |
-| `memory_stats` | Get statistics about stored memories |
-
-## Usage Examples
-
-```
-"Remember that the user prefers Rust over Python for systems programming"
-"Recall what I know about user's programming preferences"
-"List my recent memories"
-"Show memory stats"
-```
-
-## Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `SHODH_API_URL` | `http://127.0.0.1:3030` | Backend server URL |
-| `SHODH_API_KEY` | (dev key) | API key for authentication |
-| `SHODH_USER_ID` | `default` | User ID for memory isolation |
-
-## Architecture
-
-```
-┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
-│   AI Client     │────▶│   MCP Server    │────▶│ Shodh Backend   │
-│ (Claude, etc.)  │     │  (this package) │     │  (Rust server)  │
-└─────────────────┘     └─────────────────┘     └─────────────────┘
-                              stdio              REST API
-```
-
-## License
-
-Apache-2.0
+# Shodh-Memory MCP Server
+
+Persistent AI memory with semantic search. Store observations, decisions, learnings, and recall them across sessions.
+
+## Features
+
+- **Semantic Search**: Find memories by meaning, not just keywords
+- **Memory Types**: Categorize as Observation, Decision, Learning, Error, Pattern, etc.
+- **Persistent**: Memories survive across sessions and restarts
+- **Fast**: Sub-millisecond retrieval with vector indexing
+
+## Installation
+
+Add to your MCP client config:
+
+**Claude Desktop / Claude Code** (`claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "shodh-memory": {
+      "command": "npx",
+      "args": ["-y", "@shodh/memory-mcp"]
+    }
+  }
+}
+```
+
+Config file locations:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+**For Cursor/other MCP clients**: Similar configuration with the npx command.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `remember` | Store a memory with optional type and tags |
+| `recall` | Semantic search to find relevant memories |
+| `context_summary` | Get categorized context for session bootstrap |
+| `list_memories` | List all stored memories |
+| `forget` | Delete a specific memory by ID |
+| `memory_stats` | Get statistics about stored memories |
+
+## Usage Examples
+
+```
+"Remember that the user prefers Rust over Python for systems programming"
+"Recall what I know about user's programming preferences"
+"List my recent memories"
+"Show memory stats"
+```
+
+## License
+
+Apache-2.0

package/dist/index.js

@@ -4945,7 +4945,7 @@ async function isServerAvailable() {
 }
 var server = new Server({
   name: "shodh-memory",
-  version: "0.1.1"
+  version: "0.1.2"
 }, {
   capabilities: {
     tools: {},
@@ -5063,6 +5063,82 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           type: "object",
           properties: {}
         }
+      },
+      {
+        name: "recall_by_tags",
+        description: "Search memories by tags. Returns memories matching ANY of the provided tags.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            tags: {
+              type: "array",
+              items: { type: "string" },
+              description: "Tags to search for (returns memories matching ANY tag)"
+            },
+            limit: {
+              type: "number",
+              description: "Maximum number of results (default: 20)",
+              default: 20
+            }
+          },
+          required: ["tags"]
+        }
+      },
+      {
+        name: "recall_by_date",
+        description: "Search memories within a date range.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            start: {
+              type: "string",
+              description: "Start date (ISO 8601 format, e.g., '2024-01-01T00:00:00Z')"
+            },
+            end: {
+              type: "string",
+              description: "End date (ISO 8601 format, e.g., '2024-12-31T23:59:59Z')"
+            },
+            limit: {
+              type: "number",
+              description: "Maximum number of results (default: 20)",
+              default: 20
+            }
+          },
+          required: ["start", "end"]
+        }
+      },
+      {
+        name: "forget_by_tags",
+        description: "Delete memories matching ANY of the provided tags.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            tags: {
+              type: "array",
+              items: { type: "string" },
+              description: "Tags to match for deletion"
+            }
+          },
+          required: ["tags"]
+        }
+      },
+      {
+        name: "forget_by_date",
+        description: "Delete memories within a date range.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            start: {
+              type: "string",
+              description: "Start date (ISO 8601 format)"
+            },
+            end: {
+              type: "string",
+              description: "End date (ISO 8601 format)"
+            }
+          },
+          required: ["start", "end"]
+        }
       }
     ]
   };
@@ -5292,6 +5368,110 @@ ${JSON.stringify(result, null, 2)}`
           ]
         };
       }
+      case "recall_by_tags": {
+        const { tags, limit = 20 } = args;
+        const result = await apiCall("/api/recall/tags", "POST", {
+          user_id: USER_ID,
+          tags,
+          limit
+        });
+        const memories = result.memories || [];
+        if (memories.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No memories found with tags: ${tags.join(", ")}`
+              }
+            ]
+          };
+        }
+        const formatted = memories.map((m, i) => {
+          const content = getContent(m);
+          return `${i + 1}. ${content.slice(0, 80)}${content.length > 80 ? "..." : ""}
+   Type: ${getType(m)} | ID: ${m.id.slice(0, 8)}...`;
+        }).join(`
+
+`);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Found ${memories.length} memories with tags [${tags.join(", ")}]:
+
+${formatted}`
+            }
+          ]
+        };
+      }
+      case "recall_by_date": {
+        const { start, end, limit = 20 } = args;
+        const result = await apiCall("/api/recall/date", "POST", {
+          user_id: USER_ID,
+          start,
+          end,
+          limit
+        });
+        const memories = result.memories || [];
+        if (memories.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No memories found between ${start} and ${end}`
+              }
+            ]
+          };
+        }
+        const formatted = memories.map((m, i) => {
+          const content = getContent(m);
+          return `${i + 1}. ${content.slice(0, 80)}${content.length > 80 ? "..." : ""}
+   Type: ${getType(m)} | Created: ${m.created_at || "unknown"}`;
+        }).join(`
+
+`);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Found ${memories.length} memories between ${start} and ${end}:
+
+${formatted}`
+            }
+          ]
+        };
+      }
+      case "forget_by_tags": {
+        const { tags } = args;
+        const result = await apiCall("/api/forget/tags", "POST", {
+          user_id: USER_ID,
+          tags
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Deleted ${result.deleted_count} memories with tags: ${tags.join(", ")}`
+            }
+          ]
+        };
+      }
+      case "forget_by_date": {
+        const { start, end } = args;
+        const result = await apiCall("/api/forget/date", "POST", {
+          user_id: USER_ID,
+          start,
+          end
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Deleted ${result.deleted_count} memories between ${start} and ${end}`
+            }
+          ]
+        };
+      }
       default:
         throw new Error(`Unknown tool: ${name}`);
     }
@@ -5377,7 +5557,7 @@ ID: ${memory.id}`
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
-  console.error("Shodh-Memory MCP server v0.1.1 running");
+  console.error("Shodh-Memory MCP server v0.1.2 running");
   console.error(`Connecting to: ${API_URL}`);
   console.error(`User ID: ${USER_ID}`);
 }

package/package.json

@@ -1,46 +1,46 @@
-{
-  "name": "@shodh/memory-mcp",
-  "version": "0.1.1",
-  "mcpName": "io.github.varun29ankuS/shodh-memory",
-  "description": "MCP server for persistent AI memory - store and recall context across sessions",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "shodh-memory-mcp": "./dist/index.js"
-  },
-  "scripts": {
-    "start": "bun run index.ts",
-    "build": "bun build index.ts --outdir dist --target node",
-    "prepublishOnly": "npm run build"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.5.0"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "memory",
-    "ai",
-    "llm",
-    "persistent-memory",
-    "semantic-search",
-    "shodh"
-  ],
-  "author": "Shodh Team <29.varuns@gmail.com>",
-  "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/varun29ankuS/shodh-memory"
-  },
-  "homepage": "https://github.com/varun29ankuS/shodh-memory#readme",
-  "bugs": {
-    "url": "https://github.com/varun29ankuS/shodh-memory/issues"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{
+  "name": "@shodh/memory-mcp",
+  "version": "0.1.4",
+  "mcpName": "io.github.varun29ankuS/shodh-memory",
+  "description": "MCP server for persistent AI memory - store and recall context across sessions",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "shodh-memory-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "start": "bun run index.ts",
+    "build": "bun build index.ts --outdir dist --target node",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "memory",
+    "ai",
+    "llm",
+    "persistent-memory",
+    "semantic-search",
+    "shodh"
+  ],
+  "author": "Shodh Team <29.varuns@gmail.com>",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/varun29ankuS/shodh-memory"
+  },
+  "homepage": "https://github.com/varun29ankuS/shodh-memory#readme",
+  "bugs": {
+    "url": "https://github.com/varun29ankuS/shodh-memory/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}