himem-mcp 1.0.0 → 1.0.2

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "himem-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "description": "Persistent memory for any AI — Claude, GPT, Gemini, Cursor. Never forget a codebase, decision, or conversation.",
   "main": "src/index.js",
   "bin": {
-    "himem-mcp": "src/index.js"
+    "himem-mcp": "./src/index.js"
   },
   "keywords": [
     "mcp",

package/src/index.js

@@ -1,277 +1,278 @@
-#!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-
-const HIMEM_API = process.env.HIMEM_API || "https://api.himem.ai";
-const HIMEM_KEY = process.env.HIMEM_KEY;
-const PROJECT = process.env.HIMEM_PROJECT || "default";
-
-if (!HIMEM_KEY) {
-    console.error("HIMEM_KEY required. Get yours at https://himem.ai");
-    process.exit(1);
-}
-
-async function himem(path, method = "GET", body = null) {
-    const res = await fetch(`${HIMEM_API}${path}`, {
-        method,
-        headers: {
-            "Authorization": `Bearer ${HIMEM_KEY}`,
-            "Content-Type": "application/json"
-        },
-        body: body ? JSON.stringify(body) : null
-    });
-    return res.json();
-}
-
-const server = new Server({
-    name: "himem",
-    version: "1.0.0"
-}, {
-    capabilities: { tools: {} }
-});
-
-server.setRequestHandler("tools/list", async () => ({
-    tools: [
-        {
-            name: "remember",
-            description: "Save something to permanent memory. Use for important facts, decisions, code snippets, or anything that should persist across sessions.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    key: { 
-                        type: "string",
-                        description: "Memory key e.g. 'architecture', 'decision-db', 'bug-fix-auth'"
-                    },
-                    value: { 
-                        type: "string",
-                        description: "What to remember"
-                    },
-                    project: {
-                        type: "string",
-                        description: "Project name (optional, defaults to default)"
-                    }
-                },
-                required: ["key", "value"]
-            }
-        },
-        {
-            name: "recall",
-            description: "Retrieve something from permanent memory by key.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    key: { type: "string", description: "Memory key to retrieve" },
-                    project: { type: "string", description: "Project name (optional)" }
-                },
-                required: ["key"]
-            }
-        },
-        {
-            name: "list_memories",
-            description: "List all memory keys for a project.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project: { type: "string", description: "Project name (optional)" }
-                }
-            }
-        },
-        {
-            name: "forget",
-            description: "Delete something from memory.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    key: { type: "string" },
-                    project: { type: "string" }
-                },
-                required: ["key"]
-            }
-        },
-        {
-            name: "load_context",
-            description: "Load full project context including architecture, decisions, and recent conversation history. Call this at the start of every session.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project: { type: "string", description: "Project name" },
-                    days: { type: "number", description: "Days of history to load (default 2)" }
-                }
-            }
-        },
-        {
-            name: "save_context",
-            description: "Save project context document (architecture, conventions, current status).",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project: { type: "string" },
-                    content: { type: "string", description: "Full context document in markdown" }
-                },
-                required: ["content"]
-            }
-        },
-        {
-            name: "save_session",
-            description: "Save current conversation messages to history. Call at end of session.",
-            inputSchema: {
-                type: "object",
-                properties: {
-                    project: { type: "string" },
-                    messages: { 
-                        type: "array",
-                        description: "Array of {role, content} message objects"
-                    }
-                },
-                required: ["messages"]
-            }
-        },
-        {
-            name: "status",
-            description: "Check himem connection status and plan details.",
-            inputSchema: {
-                type: "object",
-                properties: {}
-            }
-        }
-    ]
-}));
-
-server.setRequestHandler("tools/call", async (request) => {
-    const { name, arguments: args } = request.params;
-    const project = args.project || PROJECT;
-
-    try {
-        if (name === "remember") {
-            const result = await himem("/write", "POST", {
-                key: args.key,
-                value: args.value,
-                project
-            });
-            return {
-                content: [{
-                    type: "text",
-                    text: result.success 
-                        ? `✓ Remembered: ${args.key}` 
-                        : `✗ Failed: ${result.error}`
-                }]
-            };
-        }
-
-        if (name === "recall") {
-            const result = await himem(
-                `/read?key=${encodeURIComponent(args.key)}&project=${encodeURIComponent(project)}`
-            );
-            return {
-                content: [{
-                    type: "text",
-                    text: result.found 
-                        ? result.value 
-                        : `No memory found for key: ${args.key}`
-                }]
-            };
-        }
-
-        if (name === "list_memories") {
-            const result = await himem(
-                `/list?project=${encodeURIComponent(project)}`
-            );
-            return {
-                content: [{
-                    type: "text",
-                    text: result.keys?.length 
-                        ? `Memory keys in ${project}:\n${result.keys.map(k => `• ${k}`).join('\n')}`
-                        : `No memories found in project: ${project}`
-                }]
-            };
-        }
-
-        if (name === "forget") {
-            const result = await himem(
-                `/delete?key=${encodeURIComponent(args.key)}&project=${encodeURIComponent(project)}`,
-                "DELETE"
-            );
-            return {
-                content: [{
-                    type: "text",
-                    text: result.success 
-                        ? `✓ Forgotten: ${args.key}` 
-                        : `✗ Failed: ${result.error}`
-                }]
-            };
-        }
-
-        if (name === "load_context") {
-            const result = await himem(
-                `/context/load?project=${encodeURIComponent(project)}&days=${args.days || 2}`
-            );
-            
-            let output = "";
-            if (result.context) {
-                output += `PROJECT CONTEXT:\n${result.context}\n\n`;
-            }
-            if (result.history?.length > 0) {
-                output += `RECENT HISTORY (${result.history.length} messages):\n`;
-                output += result.history
-                    .slice(-20)
-                    .map(m => `${m.role.toUpperCase()}: ${m.content.substring(0, 200)}`)
-                    .join('\n');
-            }
-            if (!output) {
-                output = `No context found for project: ${project}. Start by saving context with save_context.`;
-            }
-            return { content: [{ type: "text", text: output }] };
-        }
-
-        if (name === "save_context") {
-            const result = await himem("/context/save", "POST", {
-                project,
-                content: args.content
-            });
-            return {
-                content: [{
-                    type: "text",
-                    text: result.success 
-                        ? `✓ Context saved for project: ${project}` 
-                        : `✗ Failed: ${result.error}`
-                }]
-            };
-        }
-
-        if (name === "save_session") {
-            const result = await himem("/session/save", "POST", {
-                project,
-                messages: args.messages
-            });
-            return {
-                content: [{
-                    type: "text",
-                    text: result.success 
-                        ? `✓ Session saved: ${result.messages_saved} messages (${result.total} total today)` 
-                        : `✗ Failed: ${result.error}`
-                }]
-            };
-        }
-
-        if (name === "status") {
-            const result = await himem("/status");
-            return {
-                content: [{
-                    type: "text",
-                    text: `HIMEM STATUS\n─────────────\nPlan: ${result.plan}\nEmail: ${result.email}\nVersion: ${result.himem_version}\nDocs: ${result.docs}`
-                }]
-            };
-        }
-
-    } catch (err) {
-        return {
-            content: [{
-                type: "text",
-                text: `HIMEM ERROR: ${err.message}`
-            }]
-        };
-    }
-});
-
-const transport = new StdioServerTransport();
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+const HIMEM_API = process.env.HIMEM_API || "https://api.himem.ai";
+const HIMEM_KEY = process.env.HIMEM_KEY;
+const PROJECT = process.env.HIMEM_PROJECT || "default";
+
+if (!HIMEM_KEY) {
+    console.error("HIMEM_KEY required. Get yours at https://himem.ai");
+    process.exit(1);
+}
+
+async function himem(path, method = "GET", body = null) {
+    const res = await fetch(`${HIMEM_API}${path}`, {
+        method,
+        headers: {
+            "Authorization": `Bearer ${HIMEM_KEY}`,
+            "Content-Type": "application/json"
+        },
+        body: body ? JSON.stringify(body) : null
+    });
+    return res.json();
+}
+
+const server = new Server({
+    name: "himem",
+    version: "1.0.0"
+}, {
+    capabilities: { tools: {} }
+});
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "remember",
+            description: "Save something to permanent memory. Use for important facts, decisions, code snippets, or anything that should persist across sessions.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    key: {
+                        type: "string",
+                        description: "Memory key e.g. 'architecture', 'decision-db', 'bug-fix-auth'"
+                    },
+                    value: {
+                        type: "string",
+                        description: "What to remember"
+                    },
+                    project: {
+                        type: "string",
+                        description: "Project name (optional, defaults to default)"
+                    }
+                },
+                required: ["key", "value"]
+            }
+        },
+        {
+            name: "recall",
+            description: "Retrieve something from permanent memory by key.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    key: { type: "string", description: "Memory key to retrieve" },
+                    project: { type: "string", description: "Project name (optional)" }
+                },
+                required: ["key"]
+            }
+        },
+        {
+            name: "list_memories",
+            description: "List all memory keys for a project.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project: { type: "string", description: "Project name (optional)" }
+                }
+            }
+        },
+        {
+            name: "forget",
+            description: "Delete something from memory.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    key: { type: "string" },
+                    project: { type: "string" }
+                },
+                required: ["key"]
+            }
+        },
+        {
+            name: "load_context",
+            description: "Load full project context including architecture, decisions, and recent conversation history. Call this at the start of every session.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project: { type: "string", description: "Project name" },
+                    days: { type: "number", description: "Days of history to load (default 2)" }
+                }
+            }
+        },
+        {
+            name: "save_context",
+            description: "Save project context document (architecture, conventions, current status).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project: { type: "string" },
+                    content: { type: "string", description: "Full context document in markdown" }
+                },
+                required: ["content"]
+            }
+        },
+        {
+            name: "save_session",
+            description: "Save current conversation messages to history. Call at end of session.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project: { type: "string" },
+                    messages: {
+                        type: "array",
+                        description: "Array of {role, content} message objects"
+                    }
+                },
+                required: ["messages"]
+            }
+        },
+        {
+            name: "status",
+            description: "Check himem connection status and plan details.",
+            inputSchema: {
+                type: "object",
+                properties: {}
+            }
+        }
+    ]
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const project = args.project || PROJECT;
+
+    try {
+        if (name === "remember") {
+            const result = await himem("/write", "POST", {
+                key: args.key,
+                value: args.value,
+                project
+            });
+            return {
+                content: [{
+                    type: "text",
+                    text: result.success
+                        ? `✓ Remembered: ${args.key}`
+                        : `✗ Failed: ${result.error}`
+                }]
+            };
+        }
+
+        if (name === "recall") {
+            const result = await himem(
+                `/read?key=${encodeURIComponent(args.key)}&project=${encodeURIComponent(project)}`
+            );
+            return {
+                content: [{
+                    type: "text",
+                    text: result.found
+                        ? result.value
+                        : `No memory found for key: ${args.key}`
+                }]
+            };
+        }
+
+        if (name === "list_memories") {
+            const result = await himem(
+                `/list?project=${encodeURIComponent(project)}`
+            );
+            return {
+                content: [{
+                    type: "text",
+                    text: result.keys?.length
+                        ? `Memory keys in ${project}:\n${result.keys.map(k => `• ${k}`).join('\n')}`
+                        : `No memories found in project: ${project}`
+                }]
+            };
+        }
+
+        if (name === "forget") {
+            const result = await himem(
+                `/delete?key=${encodeURIComponent(args.key)}&project=${encodeURIComponent(project)}`,
+                "DELETE"
+            );
+            return {
+                content: [{
+                    type: "text",
+                    text: result.success
+                        ? `✓ Forgotten: ${args.key}`
+                        : `✗ Failed: ${result.error}`
+                }]
+            };
+        }
+
+        if (name === "load_context") {
+            const result = await himem(
+                `/context/load?project=${encodeURIComponent(project)}&days=${args.days || 2}`
+            );
+
+            let output = "";
+            if (result.context) {
+                output += `PROJECT CONTEXT:\n${result.context}\n\n`;
+            }
+            if (result.history?.length > 0) {
+                output += `RECENT HISTORY (${result.history.length} messages):\n`;
+                output += result.history
+                    .slice(-20)
+                    .map(m => `${m.role.toUpperCase()}: ${m.content.substring(0, 200)}`)
+                    .join('\n');
+            }
+            if (!output) {
+                output = `No context found for project: ${project}. Start by saving context with save_context.`;
+            }
+            return { content: [{ type: "text", text: output }] };
+        }
+
+        if (name === "save_context") {
+            const result = await himem("/context/save", "POST", {
+                project,
+                content: args.content
+            });
+            return {
+                content: [{
+                    type: "text",
+                    text: result.success
+                        ? `✓ Context saved for project: ${project}`
+                        : `✗ Failed: ${result.error}`
+                }]
+            };
+        }
+
+        if (name === "save_session") {
+            const result = await himem("/session/save", "POST", {
+                project,
+                messages: args.messages
+            });
+            return {
+                content: [{
+                    type: "text",
+                    text: result.success
+                        ? `✓ Session saved: ${result.messages_saved} messages (${result.total} total today)`
+                        : `✗ Failed: ${result.error}`
+                }]
+            };
+        }
+
+        if (name === "status") {
+            const result = await himem("/status");
+            return {
+                content: [{
+                    type: "text",
+                    text: `HIMEM STATUS\n─────────────\nPlan: ${result.plan}\nEmail: ${result.email}\nVersion: ${result.himem_version}\nDocs: ${result.docs}`
+                }]
+            };
+        }
+
+    } catch (err) {
+        return {
+            content: [{
+                type: "text",
+                text: `HIMEM ERROR: ${err.message}`
+            }]
+        };
+    }
+});
+
+const transport = new StdioServerTransport();
 await server.connect(transport);