@remind_ai/remind-mcp 0.1.0

package/README.md

@@ -0,0 +1,60 @@
+# @remind_ai/remind-mcp
+
+An [MCP](https://modelcontextprotocol.io) server that gives any AI client
+[REMind](https://www.npmjs.com/package/@remind_ai/remind)'s brain-inspired memory — with the
+**MemGuard** security layer — as ready-to-call tools.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `remember(agentId, user, assistant)` | Store an exchange in long-term memory (firewalled). |
+| `recall(agentId, query)` | Retrieve a fused memory context for a query. |
+| `consolidate(agentId)` | Run the sleep cycle — episodes → durable beliefs. |
+| `forget(agentId)` | Decay stale memories. |
+
+## Use it (Claude Desktop / VS Code / Cursor)
+
+Add to your MCP config (e.g. `claude_desktop_config.json` or `.vscode/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "remind": {
+      "command": "npx",
+      "args": ["-y", "@remind_ai/remind-mcp"],
+      "env": {
+        "AZURE_OPENAI_ENDPOINT": "https://<resource>.openai.azure.com/",
+        "AZURE_OPENAI_API_KEY": "...",
+        "AZURE_OPENAI_CHAT_DEPLOYMENT": "...",
+        "AZURE_OPENAI_EMBED_DEPLOYMENT": "...",
+        "AZURE_SEARCH_ENDPOINT": "https://<service>.search.windows.net",
+        "AZURE_SEARCH_API_KEY": "...",
+        "COSMOS_GREMLIN_ENDPOINT": "wss://<account>.gremlin.cosmos.azure.com:443/",
+        "COSMOS_GREMLIN_KEY": "...",
+        "COSMOS_MONGO_URI": "mongodb+srv://<user>:<password>@<cluster>/",
+        "SYNC": "1"
+      }
+    }
+  }
+}
+```
+
+The agent can now call `remember` / `recall` / `consolidate` / `forget` on its own.
+
+## Local development
+
+```bash
+npm install
+cp .env.example .env   # fill in Azure creds
+npm start              # runs the server on stdio
+```
+
+## Publish
+
+```bash
+npm publish --access public
+```
+
+Built on the published [`@remind_ai/remind`](https://www.npmjs.com/package/@remind_ai/remind) SDK —
+one brain, many doorways.

package/dist/server.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// REMind MCP server — exposes brain-inspired agent memory (with MemGuard) over the
+// Model Context Protocol. Any MCP client (Claude Desktop, VS Code, Cursor, …) can use
+// REMind as its memory via the tools below. Communicates over stdio.
+import 'dotenv/config';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createMemory } from '@remind_ai/remind';
+import { z } from 'zod';
+const mem = createMemory();
+const server = new McpServer({ name: 'remind', version: '0.1.0' });
+server.registerTool('remember', {
+    title: 'Remember',
+    description: 'Store a user/assistant exchange in long-term memory (firewalled by MemGuard).',
+    inputSchema: { agentId: z.string(), user: z.string(), assistant: z.string().default('') },
+}, async ({ agentId, user, assistant }) => {
+    await mem.addToMemory({ agentId, messages: { user, assistant }, source: 'mcp' });
+    return { content: [{ type: 'text', text: 'stored' }] };
+});
+server.registerTool('recall', {
+    title: 'Recall',
+    description: 'Retrieve a fused memory context relevant to a query.',
+    inputSchema: { agentId: z.string(), query: z.string() },
+}, async ({ agentId, query }) => {
+    const { context } = await mem.fetchMemory(agentId, query);
+    return { content: [{ type: 'text', text: context || '(no relevant memory)' }] };
+});
+server.registerTool('consolidate', {
+    title: 'Consolidate (sleep cycle)',
+    description: 'Consolidate episodic memories into durable beliefs; returns a short report.',
+    inputSchema: { agentId: z.string() },
+}, async ({ agentId }) => {
+    const r = await mem.sleep(agentId);
+    return {
+        content: [
+            { type: 'text', text: `promoted ${r.promoted.length}, merged ${r.merged}, blocked ${r.blocked.length}` },
+        ],
+    };
+});
+server.registerTool('forget', {
+    title: 'Forget (decay)',
+    description: 'Run a decay pass over stale memories for an agent.',
+    inputSchema: { agentId: z.string() },
+}, async ({ agentId }) => {
+    await mem.forget(agentId);
+    return { content: [{ type: 'text', text: 'decay complete' }] };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+// stdout is the protocol channel — log to stderr only.
+console.error('REMind MCP server running on stdio');

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@remind_ai/remind-mcp",
+  "version": "0.1.0",
+  "description": "MCP server exposing REMind brain-inspired agent memory (with the MemGuard security layer) as Model Context Protocol tools.",
+  "type": "module",
+  "bin": { "remind-mcp": "dist/server.js" },
+  "files": ["dist"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "start": "tsx src/server.ts"
+  },
+  "keywords": ["mcp", "model-context-protocol", "memory", "ai", "agent", "remind", "memguard"],
+  "license": "MIT",
+  "engines": { "node": ">=20" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "@remind_ai/remind": "^0.1.0",
+    "dotenv": "^16.4.5",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}