ninaivagam 0.1.0

package/README.md

@@ -0,0 +1,93 @@
+# ninaivagam
+
+**ninaivagam** (Tamil: நினைவகம், "memory/remembrance") is an MCP server that gives AI coding agents (Claude Code, Cursor) persistent, project-scoped memory backed by MongoDB.
+
+It stores structured knowledge *about software projects*: folder layouts, architecture decisions, tech stack, git branch strategy, coding conventions, in-progress tasks.
+
+---
+
+## Prerequisites
+
+MongoDB must be running. Quick start with Docker:
+
+```bash
+docker run -d -p 27017:27017 --name mongo mongo:7
+```
+
+---
+
+## Add to Claude Code
+
+In `~/.claude/settings.json` (global) or `.claude/settings.json` (project):
+
+```json
+{
+  "mcpServers": {
+    "ninaivagam": {
+      "command": "npx",
+      "args": ["-y", "ninaivagam"],
+      "env": {
+        "MONGO_URI": "mongodb://localhost:27017",
+        "DB_NAME": "agent-memory"
+      }
+    }
+  }
+}
+```
+
+Or if installed globally (`npm install -g ninaivagam`):
+
+```json
+{
+  "mcpServers": {
+    "ninaivagam": {
+      "command": "ninaivagam",
+      "env": {
+        "MONGO_URI": "mongodb://localhost:27017"
+      }
+    }
+  }
+}
+```
+
+---
+
+## Add to Cursor
+
+Open Cursor Settings > MCP > Add server:
+- **Command:** `npx`
+- **Args:** `["-y", "ninaivagam"]`
+- **Env:** `MONGO_URI=mongodb://localhost:27017`
+
+---
+
+## Environment Variables
+
+| Variable      | Default                     | Description                    |
+|---------------|-----------------------------|--------------------------------|
+| `MONGO_URI`   | `mongodb://localhost:27017` | MongoDB connection string      |
+| `DB_NAME`     | `agent-memory`              | MongoDB database name          |
+| `SERVER_NAME` | `ninaivagam`                | Name reported in MCP handshake |
+
+---
+
+## MCP Tools
+
+| Tool              | Inputs                                  | Purpose                            |
+|-------------------|-----------------------------------------|------------------------------------|
+| `store_memory`    | projectId, category, key, value, tags?  | Create or overwrite a memory entry |
+| `retrieve_memory` | projectId, key, category?               | Fetch one memory by key            |
+| `list_memories`   | projectId, category?, tags?, limit?     | List with optional filters         |
+| `delete_memory`   | projectId, category, key                | Remove a memory entry              |
+
+---
+
+## Memory Categories
+
+`architecture` · `stack` · `folder-structure` · `git` · `convention` · `task` · `decision` · `other`
+
+---
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+export declare const config: Readonly<{
+    MONGO_URI: string;
+    DB_NAME: string;
+    SERVER_NAME: string;
+    SERVER_VERSION: string;
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM;;;;;EAKjB,CAAC"}

package/dist/config.js

@@ -0,0 +1,8 @@
+import pkg from "../package.json" with { type: "json" };
+export const config = Object.freeze({
+    MONGO_URI: process.env.MONGO_URI ?? "mongodb://localhost:27017",
+    DB_NAME: process.env.DB_NAME ?? "agent-memory",
+    SERVER_NAME: process.env.SERVER_NAME ?? "ninaivagam",
+    SERVER_VERSION: pkg.version,
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExD,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,2BAA2B;IAC/D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,cAAc;IAC9C,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,YAAY;IACpD,cAAc,EAAE,GAAG,CAAC,OAAO;CAC5B,CAAC,CAAC"}

package/dist/db/connection.d.ts

@@ -0,0 +1,3 @@
+export declare function connectDB(): Promise<void>;
+export declare function disconnectDB(): Promise<void>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAGA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAS/C;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAOlD"}

package/dist/db/connection.js

@@ -0,0 +1,24 @@
+import mongoose from "mongoose";
+import { config } from "../config.js";
+export async function connectDB() {
+    if (mongoose.connection.readyState !== 0)
+        return;
+    try {
+        await mongoose.connect(config.MONGO_URI, { dbName: config.DB_NAME });
+        console.error("ninaivagam connected to MongoDB");
+    }
+    catch (err) {
+        console.error("[ninaivagam] Failed to connect to MongoDB:", err);
+        process.exit(1);
+    }
+}
+export async function disconnectDB() {
+    try {
+        await mongoose.disconnect();
+        console.error("[ninaivagam] Disconnected from MongoDB");
+    }
+    catch (err) {
+        console.error("[ninaivagam] Error during disconnect:", err);
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,KAAK,CAAC;QAAE,OAAO;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACrE,OAAO,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC"}

package/dist/db/memory.model.d.ts

@@ -0,0 +1,8 @@
+import mongoose from "mongoose";
+import { type IMemory } from "../types.js";
+export declare const Memory: mongoose.Model<IMemory, {}, {}, {}, mongoose.Document<unknown, {}, IMemory, {}, {}> & IMemory & {
+    _id: mongoose.Types.ObjectId;
+} & {
+    __v: number;
+}, any>;
+//# sourceMappingURL=memory.model.d.ts.map

package/dist/db/memory.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.model.d.ts","sourceRoot":"","sources":["../../src/db/memory.model.ts"],"names":[],"mappings":"AAAA,OAAO,QAAoB,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAgB9D,eAAO,MAAM,MAAM;;;;OAAkD,CAAC"}

package/dist/db/memory.model.js

@@ -0,0 +1,13 @@
+import mongoose, { Schema } from "mongoose";
+import { MEMORY_CATEGORIES } from "../types.js";
+const MemorySchema = new Schema({
+    projectId: { type: String, required: true, index: true },
+    category: { type: String, required: true, enum: MEMORY_CATEGORIES },
+    key: { type: String, required: true, maxlength: 100 },
+    value: { type: String, required: true },
+    tags: { type: [String], default: [] },
+}, { timestamps: true });
+// One key per category per project — store_memory upserts on this triple
+MemorySchema.index({ projectId: 1, category: 1, key: 1 }, { unique: true });
+export const Memory = mongoose.model("Memory", MemorySchema);
+//# sourceMappingURL=memory.model.js.map

package/dist/db/memory.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.model.js","sourceRoot":"","sources":["../../src/db/memory.model.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAC;AAE9D,MAAM,YAAY,GAAG,IAAI,MAAM,CAC7B;IACE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE;IACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE;IACnE,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE;IACrD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE;IACvC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;CACtC,EACD,EAAE,UAAU,EAAE,IAAI,EAAE,CACrB,CAAC;AAEF,yEAAyE;AACzE,YAAY,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAU,QAAQ,EAAE,YAAY,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { connectDB, disconnectDB } from "./db/connection.js";
+import { server } from "./server.js";
+async function main() {
+    await connectDB();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[ninaivagam] MCP server running on stdio");
+    const shutdown = async () => {
+        await disconnectDB();
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+}
+main().catch((err) => {
+    console.error("[ninaivagam] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,EAAE,CAAC;IAElB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAE1D,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,YAAY,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const server: McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE,eAAO,MAAM,MAAM,WAGjB,CAAC"}

package/dist/server.js

@@ -0,0 +1,12 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { config } from "./config.js";
+import { storeMemorySchema, storeMemoryHandler, retrieveMemorySchema, retrieveMemoryHandler, listMemoriesSchema, listMemoriesHandler, deleteMemorySchema, deleteMemoryHandler, } from "./tools/index.js";
+export const server = new McpServer({
+    name: config.SERVER_NAME,
+    version: config.SERVER_VERSION,
+});
+server.tool("store_memory", "Store or update a piece of project knowledge (architecture, stack, folder structure, git strategy, convention, task, decision, etc.)", storeMemorySchema, storeMemoryHandler);
+server.tool("retrieve_memory", "Fetch a single memory entry by project and key", retrieveMemorySchema, retrieveMemoryHandler);
+server.tool("list_memories", "List memory entries for a project, optionally filtered by category or tags", listMemoriesSchema, listMemoriesHandler);
+server.tool("delete_memory", "Delete a memory entry by project, category, and key", deleteMemorySchema, deleteMemoryHandler);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC,cAAc;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,IAAI,CACT,cAAc,EACd,sIAAsI,EACtI,iBAAiB,EACjB,kBAAkB,CACnB,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,gDAAgD,EAChD,oBAAoB,EACpB,qBAAqB,CACtB,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,4EAA4E,EAC5E,kBAAkB,EAClB,mBAAmB,CACpB,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,qDAAqD,EACrD,kBAAkB,EAClB,mBAAmB,CACpB,CAAC"}

package/dist/tools/delete.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const deleteMemorySchema: {
+    projectId: z.ZodString;
+    category: z.ZodEnum<["architecture", "stack", "folder-structure", "git", "convention", "task", "decision", "other"]>;
+    key: z.ZodString;
+};
+export declare function deleteMemoryHandler(input: z.infer<z.ZodObject<typeof deleteMemorySchema>>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=delete.d.ts.map

package/dist/tools/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/tools/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;;;;CAI9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAAC;;;;;;;;;;;;GA0BvD"}

package/dist/tools/delete.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { Memory } from "../db/memory.model.js";
+import { MEMORY_CATEGORIES } from "../types.js";
+export const deleteMemorySchema = {
+    projectId: z.string().min(1),
+    category: z.enum(MEMORY_CATEGORIES),
+    key: z.string().min(1),
+};
+export async function deleteMemoryHandler(input) {
+    try {
+        const result = await Memory.deleteOne({
+            projectId: input.projectId,
+            category: input.category,
+            key: input.key,
+        });
+        const deleted = result.deletedCount > 0;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: deleted
+                        ? `Memory deleted: project="${input.projectId}" category="${input.category}" key="${input.key}".`
+                        : `No memory found to delete: project="${input.projectId}" category="${input.category}" key="${input.key}".`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error deleting memory: ${String(err)}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=delete.js.map

package/dist/tools/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/tools/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACvB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAsD;IAEtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;YACpC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC;QACxC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,OAAO;wBACX,CAAC,CAAC,4BAA4B,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,QAAQ,UAAU,KAAK,CAAC,GAAG,IAAI;wBACjG,CAAC,CAAC,uCAAuC,KAAK,CAAC,SAAS,eAAe,KAAK,CAAC,QAAQ,UAAU,KAAK,CAAC,GAAG,IAAI;iBAC/G;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACnF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+export { storeMemorySchema, storeMemoryHandler } from "./store.js";
+export { retrieveMemorySchema, retrieveMemoryHandler } from "./retrieve.js";
+export { listMemoriesSchema, listMemoriesHandler } from "./list.js";
+export { deleteMemorySchema, deleteMemoryHandler } from "./delete.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,5 @@
+export { storeMemorySchema, storeMemoryHandler } from "./store.js";
+export { retrieveMemorySchema, retrieveMemoryHandler } from "./retrieve.js";
+export { listMemoriesSchema, listMemoriesHandler } from "./list.js";
+export { deleteMemorySchema, deleteMemoryHandler } from "./delete.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}

package/dist/tools/list.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export declare const listMemoriesSchema: {
+    projectId: z.ZodString;
+    category: z.ZodOptional<z.ZodEnum<["architecture", "stack", "folder-structure", "git", "convention", "task", "decision", "other"]>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function listMemoriesHandler(input: z.infer<z.ZodObject<typeof listMemoriesSchema>>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=list.d.ts.map

package/dist/tools/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAAC;;;;;;;;;;;;GAoCvD"}

package/dist/tools/list.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { Memory } from "../db/memory.model.js";
+import { MEMORY_CATEGORIES } from "../types.js";
+export const listMemoriesSchema = {
+    projectId: z.string().min(1),
+    category: z.enum(MEMORY_CATEGORIES).optional(),
+    tags: z.array(z.string()).optional(),
+    limit: z.number().int().min(1).max(200).optional(),
+};
+export async function listMemoriesHandler(input) {
+    try {
+        const filter = { projectId: input.projectId };
+        if (input.category)
+            filter.category = input.category;
+        if (input.tags && input.tags.length > 0)
+            filter.tags = { $in: input.tags };
+        const docs = await Memory.find(filter)
+            .limit(input.limit ?? 50)
+            .lean();
+        const results = docs.map((d) => ({
+            category: d.category,
+            key: d.key,
+            value: d.value.length > 500 ? d.value.slice(0, 500) + "…" : d.value,
+            tags: d.tags,
+            updatedAt: d.updatedAt,
+        }));
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: results.length === 0
+                        ? `No memories found for project="${input.projectId}".`
+                        : JSON.stringify(results, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error listing memories: ${String(err)}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/tools/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IAC9C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAsD;IAEtD,IAAI,CAAC;QACH,MAAM,MAAM,GAA4B,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QACvE,IAAI,KAAK,CAAC,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QACrD,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QAE3E,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aACnC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;aACxB,IAAI,EAAE,CAAC;QAEV,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK;YACnE,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EACF,OAAO,CAAC,MAAM,KAAK,CAAC;wBAClB,CAAC,CAAC,kCAAkC,KAAK,CAAC,SAAS,IAAI;wBACvD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvC;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,2BAA2B,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACpF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/retrieve.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export declare const retrieveMemorySchema: {
+    projectId: z.ZodString;
+    key: z.ZodString;
+    category: z.ZodOptional<z.ZodEnum<["architecture", "stack", "folder-structure", "git", "convention", "task", "decision", "other"]>>;
+};
+export declare function retrieveMemoryHandler(input: z.infer<z.ZodObject<typeof retrieveMemorySchema>>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=retrieve.d.ts.map

package/dist/tools/retrieve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve.d.ts","sourceRoot":"","sources":["../../src/tools/retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB;;;;CAIhC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,oBAAoB,CAAC,CAAC;;;;;;;;;;;;GA+CzD"}

package/dist/tools/retrieve.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { Memory } from "../db/memory.model.js";
+import { MEMORY_CATEGORIES } from "../types.js";
+export const retrieveMemorySchema = {
+    projectId: z.string().min(1),
+    key: z.string().min(1),
+    category: z.enum(MEMORY_CATEGORIES).optional(),
+};
+export async function retrieveMemoryHandler(input) {
+    try {
+        const filter = {
+            projectId: input.projectId,
+            key: input.key,
+        };
+        if (input.category)
+            filter.category = input.category;
+        const doc = await Memory.findOne(filter).lean();
+        if (!doc) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No memory found for project="${input.projectId}" key="${input.key}"${input.category ? ` category="${input.category}"` : ""}.`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        id: doc._id,
+                        projectId: doc.projectId,
+                        category: doc.category,
+                        key: doc.key,
+                        value: doc.value,
+                        tags: doc.tags,
+                        updatedAt: doc.updatedAt,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error retrieving memory: ${String(err)}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=retrieve.js.map

package/dist/tools/retrieve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieve.js","sourceRoot":"","sources":["../../src/tools/retrieve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAwD;IAExD,IAAI,CAAC;QACH,MAAM,MAAM,GAA4B;YACtC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;SACf,CAAC;QACF,IAAI,KAAK,CAAC,QAAQ;YAAE,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAErD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,gCAAgC,KAAK,CAAC,SAAS,UAAU,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;qBACrI;iBACF;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,EAAE,EAAE,GAAG,CAAC,GAAG;wBACX,SAAS,EAAE,GAAG,CAAC,SAAS;wBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;wBACtB,GAAG,EAAE,GAAG,CAAC,GAAG;wBACZ,KAAK,EAAE,GAAG,CAAC,KAAK;wBAChB,IAAI,EAAE,GAAG,CAAC,IAAI;wBACd,SAAS,EAAE,GAAG,CAAC,SAAS;qBACzB,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACrF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/store.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const storeMemorySchema: {
+    projectId: z.ZodString;
+    category: z.ZodEnum<["architecture", "stack", "folder-structure", "git", "convention", "task", "decision", "other"]>;
+    key: z.ZodString;
+    value: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare function storeMemoryHandler(input: z.infer<z.ZodObject<typeof storeMemorySchema>>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=store.d.ts.map

package/dist/tools/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;;;;CAM7B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,iBAAiB,CAAC,CAAC;;;;;;;;;;;;GAsBtD"}

package/dist/tools/store.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { Memory } from "../db/memory.model.js";
+import { MEMORY_CATEGORIES } from "../types.js";
+export const storeMemorySchema = {
+    projectId: z.string().min(1),
+    category: z.enum(MEMORY_CATEGORIES),
+    key: z.string().min(1).max(100),
+    value: z.string().min(1),
+    tags: z.array(z.string()).optional(),
+};
+export async function storeMemoryHandler(input) {
+    try {
+        const doc = await Memory.findOneAndUpdate({ projectId: input.projectId, category: input.category, key: input.key }, { value: input.value, tags: input.tags ?? [] }, { upsert: true, new: true });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Memory stored.\nid: ${doc._id}\nproject: ${doc.projectId}\ncategory: ${doc.category}\nkey: ${doc.key}\nupdatedAt: ${doc.updatedAt.toISOString()}`,
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: `Error storing memory: ${String(err)}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/tools/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/tools/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAqD;IAErD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CACvC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EACxE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,EAC9C,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,CAC5B,CAAC;QACF,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,uBAAuB,GAAG,CAAC,GAAG,cAAc,GAAG,CAAC,SAAS,eAAe,GAAG,CAAC,QAAQ,UAAU,GAAG,CAAC,GAAG,gBAAgB,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE;iBACzJ;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,yBAAyB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YAClF,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+export declare const MEMORY_CATEGORIES: readonly ["architecture", "stack", "folder-structure", "git", "convention", "task", "decision", "other"];
+export type MemoryCategory = (typeof MEMORY_CATEGORIES)[number];
+export interface IMemory {
+    projectId: string;
+    category: MemoryCategory;
+    key: string;
+    value: string;
+    tags: string[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,0GASpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,cAAc,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,11 @@
+export const MEMORY_CATEGORIES = [
+    "architecture",
+    "stack",
+    "folder-structure",
+    "git",
+    "convention",
+    "task",
+    "decision",
+    "other",
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,cAAc;IACd,OAAO;IACP,kBAAkB;IAClB,KAAK;IACL,YAAY;IACZ,MAAM;IACN,UAAU;IACV,OAAO;CACC,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "ninaivagam",
+  "version": "0.1.0",
+  "description": "MCP server that gives AI agents persistent, project-scoped memory backed by MongoDB",
+  "keywords": [
+    "mcp",
+    "claude",
+    "cursor",
+    "ai-agent",
+    "memory",
+    "modelcontextprotocol"
+  ],
+  "author": "thamizharasanj",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "bin": {
+    "ninaivagam": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "mongoose": "^8.9.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}