@mmnto/mcp 0.1.0

package/dist/context.d.ts

@@ -0,0 +1,19 @@
+import type { Embedder, TotemConfig } from '@mmnto/totem';
+import { LanceStore } from '@mmnto/totem';
+export interface ServerContext {
+    projectRoot: string;
+    config: TotemConfig;
+    store: LanceStore;
+    embedder: Embedder;
+}
+/**
+ * Re-open the cached LanceStore connection after a full sync rebuild.
+ * No-op if the context hasn't been initialized yet.
+ */
+export declare function reconnectStore(): Promise<void>;
+/**
+ * Lazily initialize and return the shared server context.
+ * Config, embedder, and LanceStore are created on first call and cached.
+ */
+export declare function getContext(): Promise<ServerContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAkB,UAAU,EAAqB,MAAM,cAAc,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpD;AAiCD;;;GAGG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,CAsBzD"}

package/dist/context.js

@@ -0,0 +1,64 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createEmbedder, LanceStore, TotemConfigSchema } from '@mmnto/totem';
+let cached;
+/**
+ * Re-open the cached LanceStore connection after a full sync rebuild.
+ * No-op if the context hasn't been initialized yet.
+ */
+export async function reconnectStore() {
+    if (cached) {
+        await cached.store.reconnect();
+    }
+}
+/**
+ * Load environment variables from .env file (does not override existing).
+ */
+function loadEnv(cwd) {
+    const envPath = path.join(cwd, '.env');
+    if (!fs.existsSync(envPath))
+        return;
+    const content = fs.readFileSync(envPath, 'utf-8');
+    for (const line of content.split('\n')) {
+        const match = line.match(/^([^#=]+)=(.*)$/);
+        if (match) {
+            const key = match[1].trim();
+            const value = match[2].trim();
+            if (!process.env[key]) {
+                process.env[key] = value;
+            }
+        }
+    }
+}
+/**
+ * Load and parse totem.config.ts via jiti.
+ */
+async function loadConfig(configPath) {
+    const { createJiti } = await import('jiti');
+    const jiti = createJiti(import.meta.url);
+    const mod = (await jiti.import(configPath));
+    const raw = mod['default'] ?? mod;
+    return TotemConfigSchema.parse(raw);
+}
+/**
+ * Lazily initialize and return the shared server context.
+ * Config, embedder, and LanceStore are created on first call and cached.
+ */
+export async function getContext() {
+    if (cached)
+        return cached;
+    const projectRoot = process.cwd();
+    const configPath = path.join(projectRoot, 'totem.config.ts');
+    if (!fs.existsSync(configPath)) {
+        throw new Error('[Totem Error] No totem.config.ts found in current directory. Run `totem init` first.');
+    }
+    loadEnv(projectRoot);
+    const config = await loadConfig(configPath);
+    const embedder = createEmbedder(config.embedding);
+    const storePath = path.join(projectRoot, config.lanceDir);
+    const store = new LanceStore(storePath, embedder);
+    await store.connect();
+    cached = { projectRoot, config, store, embedder };
+    return cached;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

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,18 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { registerAddLesson } from './tools/add-lesson.js';
+import { registerSearchKnowledge } from './tools/search-knowledge.js';
+const require = createRequire(import.meta.url);
+const { version } = z.object({ version: z.string() }).parse(require('../package.json'));
+const server = new McpServer({
+    name: '@mmnto/totem',
+    version,
+});
+registerSearchKnowledge(server);
+registerAddLesson(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAExF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,cAAc;IACpB,OAAO;CACR,CAAC,CAAC;AAEH,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/add-lesson.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAddLesson(server: McpServer): void;
+//# sourceMappingURL=add-lesson.d.ts.map

package/dist/tools/add-lesson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-lesson.d.ts","sourceRoot":"","sources":["../../src/tools/add-lesson.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuBzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsFzD"}

package/dist/tools/add-lesson.js

@@ -0,0 +1,98 @@
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { z } from 'zod';
+import { getContext, reconnectStore } from '../context.js';
+/**
+ * Detect the correct package-manager command for running `totem sync`.
+ */
+function detectSyncCommand(projectRoot) {
+    if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml'))) {
+        return { cmd: 'pnpm', args: ['exec', 'totem', 'sync', '--incremental'] };
+    }
+    if (fs.existsSync(path.join(projectRoot, 'yarn.lock'))) {
+        return { cmd: 'yarn', args: ['totem', 'sync', '--incremental'] };
+    }
+    return { cmd: 'npx', args: ['totem', 'sync', '--incremental'] };
+}
+const RECONNECT_DELAY_MS = 5_000;
+/** Debounce guard — prevents concurrent sync processes. */
+let syncPending = false;
+export function registerAddLesson(server) {
+    server.registerTool('add_lesson', {
+        description: 'Persist a lesson learned to .totem/lessons.md. An incremental re-index is automatically triggered in the background.',
+        inputSchema: {
+            lesson: z.string().describe('The lesson text to persist'),
+            context_tags: z
+                .array(z.string())
+                .describe('Tags for categorization (e.g. ["caching", "nextjs", "trap"])'),
+        },
+        annotations: {
+            readOnlyHint: false,
+        },
+    }, async ({ lesson, context_tags }) => {
+        try {
+            const { projectRoot, config } = await getContext();
+            const totemDir = path.join(projectRoot, config.totemDir);
+            await fs.promises.mkdir(totemDir, { recursive: true });
+            const lessonsPath = path.join(totemDir, 'lessons.md');
+            const timestamp = new Date().toISOString();
+            const tags = context_tags.join(', ');
+            const entry = `\n## Lesson — ${timestamp}\n\n` + `**Tags:** ${tags}\n\n` + `${lesson}\n`;
+            await fs.promises.appendFile(lessonsPath, entry, 'utf-8');
+            // Fire-and-forget: spawn background incremental sync so the lesson
+            // is searchable within this session (Issue #22).
+            // Debounce: skip if a sync is already in flight.
+            if (!syncPending) {
+                syncPending = true;
+                const { cmd, args } = detectSyncCommand(projectRoot);
+                const logPath = path.join(totemDir, 'mcp-sync.log');
+                const logFd = fs.openSync(logPath, 'a');
+                try {
+                    const child = spawn(cmd, args, {
+                        cwd: projectRoot,
+                        detached: true,
+                        stdio: ['ignore', logFd, logFd],
+                        shell: true,
+                        windowsHide: true,
+                    });
+                    child.unref();
+                }
+                finally {
+                    fs.closeSync(logFd);
+                }
+                // Reconnect the store after the sync has had time to finish,
+                // so the next search_knowledge call sees the new data.
+                const errLogPath = path.join(totemDir, 'mcp-errors.log');
+                setTimeout(() => {
+                    reconnectStore()
+                        .catch((err) => {
+                        const msg = `[${new Date().toISOString()}] Store reconnect failed: ${err instanceof Error ? err.message : String(err)}\n`;
+                        fs.promises.appendFile(errLogPath, msg, 'utf-8').catch(() => {
+                            // Last-resort: file logging failed — nothing left to do.
+                        });
+                    })
+                        .finally(() => {
+                        syncPending = false;
+                    });
+                }, RECONNECT_DELAY_MS);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Lesson saved to ${config.totemDir}/lessons.md. Background re-index triggered — it will be searchable shortly.`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const originalMessage = err instanceof Error ? err.message : String(err);
+            const message = originalMessage.startsWith('[Totem Error]')
+                ? originalMessage
+                : `[Totem Error] Failed to add lesson: ${originalMessage}`;
+            return { content: [{ type: 'text', text: message }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=add-lesson.js.map

package/dist/tools/add-lesson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-lesson.js","sourceRoot":"","sources":["../../src/tools/add-lesson.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-knowledge.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchKnowledge(server: McpServer): void;
+//# sourceMappingURL=search-knowledge.d.ts.map

package/dist/tools/search-knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-knowledge.d.ts","sourceRoot":"","sources":["../../src/tools/search-knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA6CzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwD/D"}

package/dist/tools/search-knowledge.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import { ContentTypeSchema } from '@mmnto/totem';
+import { getContext, reconnectStore } from '../context.js';
+// Heuristic to detect stale LanceDB file handles after a full sync rebuild.
+// Observed errors that indicate a stale handle:
+//   - "IO-error: ... not found" when underlying .lance files are deleted
+//   - "LanceError: ..." for other file access issues after rebuild
+// TODO: Replace with error codes if future LanceDB versions expose them.
+const LANCE_STALE_ERROR_PATTERN = /not found|LanceError/i;
+async function performSearch(query, typeFilter, maxResults) {
+    const { store } = await getContext();
+    const results = await store.search({
+        query,
+        typeFilter,
+        maxResults: maxResults ?? 5,
+    });
+    if (results.length === 0) {
+        return { content: [{ type: 'text', text: 'No results found.' }] };
+    }
+    const formatted = results
+        .map((r, i) => `### ${i + 1}. ${r.label} (${r.type})\n` +
+        `**File:** ${r.filePath} | **Score:** ${r.score.toFixed(3)}\n\n` +
+        `${r.content}`)
+        .join('\n\n---\n\n');
+    return { content: [{ type: 'text', text: formatted }] };
+}
+export function registerSearchKnowledge(server) {
+    server.registerTool('search_knowledge', {
+        description: 'Search the Totem knowledge index for relevant code, session logs, specs, or lessons.',
+        inputSchema: {
+            query: z.string().describe('The search query'),
+            type_filter: z
+                .enum(ContentTypeSchema.options)
+                .optional()
+                .describe('Filter results by content type: code, session_log, or spec'),
+            max_results: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Maximum number of results to return (default: 5)'),
+        },
+        annotations: {
+            readOnlyHint: true,
+        },
+    }, async ({ query, type_filter, max_results }) => {
+        try {
+            return await performSearch(query, type_filter, max_results);
+        }
+        catch (err) {
+            const originalMessage = err instanceof Error ? err.message : String(err);
+            const isStale = LANCE_STALE_ERROR_PATTERN.test(originalMessage);
+            if (isStale) {
+                try {
+                    await reconnectStore();
+                    return await performSearch(query, type_filter, max_results);
+                }
+                catch (retryErr) {
+                    const retryMessage = retryErr instanceof Error ? retryErr.message : String(retryErr);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `[Totem Error] Failed to search knowledge after reconnect: ${retryMessage}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+            }
+            const message = originalMessage.startsWith('[Totem Error]')
+                ? originalMessage
+                : `[Totem Error] Failed to search knowledge: ${originalMessage}`;
+            return { content: [{ type: 'text', text: message }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=search-knowledge.js.map

package/dist/tools/search-knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-knowledge.js","sourceRoot":"","sources":["../../src/tools/search-knowledge.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@mmnto/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Totem — AI persistent memory and context layer",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "totem-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint src/",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "dependencies": {
+    "@mmnto/totem": "workspace:*",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "jiti": "^2.4.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "author": "mmnto-ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mmnto-ai/totem.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/mmnto-ai/totem",
+  "bugs": {
+    "url": "https://github.com/mmnto-ai/totem/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}