@mneme-ai/mcp 0.8.3

package/README.md

@@ -0,0 +1,36 @@
+# @mneme-ai/mcp
+
+MCP server that exposes [Mneme](https://github.com/patsa2561-art/mneme-ai) to AI clients (Claude Code, Cursor, Continue, Copilot via MCP).
+
+You normally don't import this directly — the `mneme-ai` CLI exposes it via:
+
+```bash
+mneme mcp     # start server on stdio
+```
+
+## Tools exposed to the AI client
+
+| Tool | Purpose |
+|---|---|
+| `mneme_ask` | natural-language search over git history |
+| `mneme_why` | blame + RAG explanation for any file/line range |
+| `mneme_search_commits` | hybrid (BM25 + vector) commit search |
+| `mneme_status` | what's indexed |
+
+## Client config
+
+```json
+{
+  "mcpServers": {
+    "mneme": {
+      "command": "npx",
+      "args": ["-y", "mneme-ai", "mcp"],
+      "cwd": "/abs/path/to/your/repo"
+    }
+  }
+}
+```
+
+## License
+
+MIT.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export interface McpOptions {
+    cwd: string;
+}
+export declare function startMcpServer(opts: McpOptions): Promise<void>;
+//# 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":"AAaA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AAyFD,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsLpE"}

package/dist/index.js

@@ -0,0 +1,304 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { git, retrieve, store } from "@mneme-ai/core";
+import { resolveEmbedder } from "@mneme-ai/embeddings";
+const TOOLS = [
+    {
+        name: "mneme_ask",
+        description: "Ask the codebase memory a question about WHY something exists. Returns the most relevant commits and PRs with citations.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                question: { type: "string", description: "Natural language question" },
+                topK: { type: "number", description: "Max results (default 8)" },
+            },
+            required: ["question"],
+        },
+    },
+    {
+        name: "mneme_why",
+        description: "Explain why a specific file (or line range) exists by combining git blame with related commits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file: { type: "string", description: "Path relative to repo root" },
+                startLine: { type: "number" },
+                endLine: { type: "number" },
+            },
+            required: ["file"],
+        },
+    },
+    {
+        name: "mneme_search_commits",
+        description: "Hybrid (lexical + semantic) search over indexed commits and PRs.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string" },
+                topK: { type: "number" },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "mneme_status",
+        description: "Report what's indexed, the embedder, and DB stats.",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "mneme_list_entities",
+        description: "List indexed source-code entities (functions, classes, types, exported variables) with optional filtering by language/kind/path-prefix.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                kind: { type: "string", description: "function | class | type | variable | module" },
+                language: { type: "string", description: "typescript | tsx | javascript | jsx" },
+                pathPrefix: { type: "string", description: "Only entities under this path" },
+                limit: { type: "number", description: "Max rows (default 100)" },
+            },
+        },
+    },
+    {
+        name: "mneme_find_similar",
+        description: "Given an entity id (from mneme_list_entities) OR a code snippet, return the top-K most semantically similar entities in the repo.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entityId: { type: "string", description: "Existing entity id" },
+                snippet: { type: "string", description: "Or a code snippet to compare against" },
+                topK: { type: "number" },
+            },
+        },
+    },
+    {
+        name: "mneme_blast",
+        description: "Predict the blast radius of shipping a commit: which past incidents share its file footprint, plus a base-rate verdict (LOW/MED/HIGH).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                commit: { type: "string", description: "Commit hash, short hash, or HEAD-relative ref" },
+                windowHours: { type: "number" },
+            },
+            required: ["commit"],
+        },
+    },
+];
+export async function startMcpServer(opts) {
+    if (!(await git.isGitRepo(opts.cwd))) {
+        throw new Error(`Mneme MCP: not in a git repo (${opts.cwd}).`);
+    }
+    const meta = await git.getRepoMeta(opts.cwd);
+    const dbDir = join(meta.rootPath, ".mneme");
+    if (!existsSync(dbDir))
+        mkdirSync(dbDir, { recursive: true });
+    const dbPath = join(dbDir, "mneme.db");
+    const s = new store.MnemeStore(dbPath);
+    const embedder = await resolveEmbedder({ provider: "auto" });
+    const server = new Server({ name: "mneme", version: "0.1.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const args = (req.params.arguments ?? {});
+        try {
+            switch (req.params.name) {
+                case "mneme_ask": {
+                    const result = await retrieve.ask(String(args["question"] ?? ""), {
+                        store: s,
+                        embedder,
+                        repo: meta,
+                        topK: typeof args["topK"] === "number" ? args["topK"] : 8,
+                    });
+                    return jsonResult(toAskPayload(result));
+                }
+                case "mneme_search_commits": {
+                    const results = await retrieve.search(String(args["query"] ?? ""), {
+                        store: s,
+                        embedder,
+                        repo: meta,
+                        topK: typeof args["topK"] === "number" ? args["topK"] : 8,
+                    });
+                    return jsonResult(results.map(toSearchPayload));
+                }
+                case "mneme_why": {
+                    const file = String(args["file"] ?? "");
+                    const sl = typeof args["startLine"] === "number" ? args["startLine"] : undefined;
+                    const el = typeof args["endLine"] === "number" ? args["endLine"] : undefined;
+                    const blamed = await git.blame(meta.rootPath, file, sl, el);
+                    const tally = new Map();
+                    for (const b of blamed)
+                        tally.set(b.commitHash, (tally.get(b.commitHash) ?? 0) + 1);
+                    const top = Array.from(tally.entries())
+                        .sort((a, b) => b[1] - a[1])
+                        .slice(0, 8)
+                        .map(([h, count]) => ({
+                        commit: s.getCommit(h) ?? null,
+                        hash: h,
+                        lineCount: count,
+                    }));
+                    return jsonResult({ file, startLine: sl, endLine: el, originating: top });
+                }
+                case "mneme_status": {
+                    return jsonResult({
+                        commits: s.countCommits(),
+                        chunks: s.countChunks(),
+                        embedded: s.countChunksWithEmbedding(),
+                        entities: s.countEntities(),
+                        entitiesEmbedded: s.countEntitiesWithEmbedding(),
+                        synthesizedNotes: s.countSynthesizedNotes(),
+                        embedder: s.getMeta("embedder"),
+                        repoRoot: meta.rootPath,
+                        host: meta.host,
+                        owner: meta.owner,
+                        repo: meta.repo,
+                    });
+                }
+                case "mneme_list_entities": {
+                    const where = [];
+                    const params = [];
+                    if (args["kind"]) {
+                        where.push("kind = ?");
+                        params.push(String(args["kind"]));
+                    }
+                    if (args["language"]) {
+                        where.push("language = ?");
+                        params.push(String(args["language"]));
+                    }
+                    if (args["pathPrefix"]) {
+                        where.push("file_path LIKE ?");
+                        params.push(`${String(args["pathPrefix"])}%`);
+                    }
+                    const limit = typeof args["limit"] === "number" ? Math.min(500, args["limit"]) : 100;
+                    const sql = "SELECT id, kind, name, file_path, start_line, end_line, signature, language FROM entities" +
+                        (where.length ? " WHERE " + where.join(" AND ") : "") +
+                        " ORDER BY file_path, start_line LIMIT ?";
+                    const rows = s.db.prepare(sql).all(...params, limit);
+                    return jsonResult({ entities: rows, count: rows.length });
+                }
+                case "mneme_find_similar": {
+                    const topK = typeof args["topK"] === "number" ? args["topK"] : 5;
+                    const entityId = args["entityId"] ? String(args["entityId"]) : undefined;
+                    const snippet = args["snippet"] ? String(args["snippet"]) : undefined;
+                    let queryVec = null;
+                    if (entityId) {
+                        // Use the stored embedding directly.
+                        const row = s.db
+                            .prepare("SELECT embedding FROM entities WHERE id = ?")
+                            .get(entityId);
+                        if (!row?.embedding) {
+                            return errorResult(`No embedding for entity ${entityId}. Run \`mneme entities\` first.`);
+                        }
+                        queryVec = new Float32Array(row.embedding.buffer, row.embedding.byteOffset, row.embedding.length / 4);
+                    }
+                    else if (snippet) {
+                        const [v] = await embedder.embed([snippet]);
+                        queryVec = v ?? null;
+                    }
+                    else {
+                        return errorResult("mneme_find_similar requires either entityId or snippet.");
+                    }
+                    if (!queryVec)
+                        return jsonResult({ matches: [] });
+                    const candidates = [];
+                    for (const e of s.iterEmbeddedEntities()) {
+                        if (!e.embedding)
+                            continue;
+                        if (entityId && e.id === entityId)
+                            continue;
+                        if (e.embedding.length !== queryVec.length)
+                            continue;
+                        let dot = 0;
+                        let na = 0;
+                        let nb = 0;
+                        for (let i = 0; i < queryVec.length; i++) {
+                            const av = queryVec[i];
+                            const bv = e.embedding[i];
+                            dot += av * bv;
+                            na += av * av;
+                            nb += bv * bv;
+                        }
+                        const denom = Math.sqrt(na) * Math.sqrt(nb);
+                        const sim = denom === 0 ? 0 : dot / denom;
+                        candidates.push({ entity: { ...e, embedding: undefined }, score: sim });
+                    }
+                    candidates.sort((a, b) => b.score - a.score);
+                    return jsonResult({ matches: candidates.slice(0, topK) });
+                }
+                case "mneme_blast": {
+                    const ref = String(args["commit"] ?? "");
+                    if (!ref)
+                        return errorResult("mneme_blast requires `commit`.");
+                    const r = await git.execGit(["rev-parse", ref], { cwd: meta.rootPath });
+                    if (r.code !== 0)
+                        return errorResult(`Cannot resolve commit "${ref}".`);
+                    const hash = r.stdout.trim();
+                    const c = s.getCommit(hash);
+                    if (!c)
+                        return errorResult(`Commit ${hash.slice(0, 8)} not indexed.`);
+                    const incidents = s.db
+                        .prepare("SELECT * FROM incidents")
+                        .all();
+                    const cFiles = new Set(c.files.map((p) => p.replace(/\\/g, "/").toLowerCase()));
+                    const matches = incidents
+                        .map((i) => {
+                        const inc = {
+                            id: String(i.id),
+                            title: String(i.title),
+                            affected: i.affected_files
+                                ? JSON.parse(String(i.affected_files))
+                                : [],
+                        };
+                        const overlap = inc.affected.filter((f) => cFiles.has(f.replace(/\\/g, "/").toLowerCase()));
+                        return overlap.length > 0 ? { incident: inc, overlap } : null;
+                    })
+                        .filter((x) => x !== null);
+                    return jsonResult({ commit: c.shortHash, fileCount: c.files.length, matches });
+                }
+                default:
+                    return errorResult(`unknown tool: ${req.params.name}`);
+            }
+        }
+        catch (err) {
+            return errorResult(err.message);
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function toAskPayload(r) {
+    return {
+        question: r.question,
+        summary: r.summary,
+        citations: r.citations,
+        results: r.searchResults.map(toSearchPayload),
+    };
+}
+function toSearchPayload(s) {
+    return {
+        score: s.score,
+        commit: {
+            hash: s.commit.hash,
+            shortHash: s.commit.shortHash,
+            author: s.commit.authorName,
+            date: s.commit.authorDate,
+            subject: s.commit.subject,
+            body: s.commit.body,
+            files: s.commit.files,
+            prNumber: s.commit.prNumber,
+        },
+        matchedKinds: Array.from(new Set(s.matchedChunks.map((c) => c.kind))),
+    };
+}
+function jsonResult(value) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(value, null, 2) }],
+    };
+}
+function errorResult(message) {
+    return {
+        isError: true,
+        content: [{ type: "text", text: message }],
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mneme-ai/mcp",
+  "version": "0.8.3",
+  "description": "MCP server that exposes Mneme to Claude Code, Cursor, Continue, and other AI clients",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/patsa2561-art/mneme-ai.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/patsa2561-art/mneme-ai#readme",
+  "bugs": {
+    "url": "https://github.com/patsa2561-art/mneme-ai/issues"
+  },
+  "license": "MIT",
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean"
+  },
+  "dependencies": {
+    "@mneme-ai/core": "0.8.3",
+    "@mneme-ai/embeddings": "0.8.3",
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  }
+}