mcp-for-memos 1.0.0

package/dist/server.js

@@ -0,0 +1,40 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MemosClient } from "./client.js";
+import { registerMemoTools } from "./tools/memos.js";
+import { registerTagTools } from "./tools/tags.js";
+import { registerSearchTool } from "./tools/review.js";
+import { registerPrompts } from "./prompts/index.js";
+import { VALID_VISIBILITIES } from "./types.js";
+// Crear servidor con cliente inyectado (para HTTP multi-tenant)
+export const createServerWithClient = (client, options = {}) => {
+    const defaultVisibility = options.defaultVisibility ?? "PRIVATE";
+    const server = new McpServer({
+        name: "memos-mcp",
+        version: "3.0.0",
+    });
+    registerMemoTools(server, client, { defaultVisibility });
+    registerTagTools(server, client);
+    registerSearchTool(server, client);
+    registerPrompts(server);
+    return server;
+};
+// Crear servidor con env vars (para stdio mode)
+export const createServer = () => {
+    const memosUrl = process.env.MEMOS_URL;
+    const memosToken = process.env.MEMOS_TOKEN;
+    if (!memosUrl) {
+        console.error("Error: MEMOS_URL environment variable is required");
+        process.exit(1);
+    }
+    if (!memosToken) {
+        console.error("Error: MEMOS_TOKEN environment variable is required");
+        process.exit(1);
+    }
+    const rawVisibility = process.env.MEMOS_DEFAULT_VISIBILITY?.toUpperCase();
+    const defaultVisibility = rawVisibility && VALID_VISIBILITIES.includes(rawVisibility)
+        ? rawVisibility
+        : "PRIVATE";
+    const client = new MemosClient(memosUrl, memosToken);
+    return createServerWithClient(client, { defaultVisibility });
+};
+//# 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,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,YAAY,CAAC;AAMjE,gEAAgE;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAmB,EACnB,UAAyB,EAAE,EAC3B,EAAE;IACF,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,SAAS,CAAC;IAEjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;IACzD,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACvC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAE3C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,WAAW,EAAE,CAAC;IAC1E,MAAM,iBAAiB,GACrB,aAAa,IAAI,kBAAkB,CAAC,QAAQ,CAAC,aAA2B,CAAC;QACvE,CAAC,CAAE,aAA4B;QAC/B,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrD,OAAO,sBAAsB,CAAC,MAAM,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;AAC/D,CAAC,CAAC"}

package/dist/tools/memos.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MemosClient } from "../client.js";
+import type { Visibility } from "../types.js";
+interface MemoToolsOptions {
+    defaultVisibility: Visibility;
+}
+export declare const registerMemoTools: (server: McpServer, client: MemosClient, options: MemoToolsOptions) => void;
+export {};
+//# sourceMappingURL=memos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memos.d.ts","sourceRoot":"","sources":["../../src/tools/memos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAQ,UAAU,EAAE,MAAM,aAAa,CAAC;AAmCpD,UAAU,gBAAgB;IACxB,iBAAiB,EAAE,UAAU,CAAC;CAC/B;AAED,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,EACjB,QAAQ,WAAW,EACnB,SAAS,gBAAgB,SA6G1B,CAAC"}

package/dist/tools/memos.js

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { resolveToMemoId } from "./utils.js";
+function parseToRFC3339(isoString, paramName) {
+    const date = new Date(isoString);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid date for ${paramName}. Use ISO 8601 (e.g. "2025-01-01").`);
+    }
+    return date.toISOString();
+}
+function cleanMemo(memo, baseUrl) {
+    const { nodes, snippet, creator, attachments, ...rest } = memo;
+    // Transform attachments with only useful fields
+    if (Array.isArray(attachments) && attachments.length > 0) {
+        rest.attachments = attachments.map((r) => {
+            const uid = r.name?.match(/^attachments\/(.+)$/)?.[1] || "";
+            const filename = r.filename;
+            const result = {
+                filename,
+                type: r.type || r.mime,
+                size: Number(r.size) || 0,
+                createTime: r.createTime,
+            };
+            if (uid && filename && baseUrl) {
+                result.url = `${baseUrl}/file/attachments/${uid}/${filename}`;
+            }
+            return result;
+        });
+    }
+    return rest;
+}
+export const registerMemoTools = (server, client, options) => {
+    const visibilityEnum = z.enum(["PRIVATE", "PROTECTED", "PUBLIC"]);
+    // get — retrieve a single memo
+    server.registerTool("get", {
+        description: "Get a single memo by ID or UID.",
+        inputSchema: {
+            id: z.string().min(1).describe("Memo ID or UID"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ id }) => {
+        const memo = await client.get(`/api/v1/memos/${id}`);
+        const cleaned = cleanMemo(memo, client.baseUrl);
+        return { content: [{ type: "text", text: JSON.stringify(cleaned, null, 2) }] };
+    });
+    // create — create a new memo
+    server.registerTool("create", {
+        description: "Create a memo with markdown content. Use #hashtags for tags. CRITICAL LIMIT: Each memo MUST NOT exceed 13,000 characters. The Memos server enforces a hard limit of ~18K but to avoid errors always stay under 13K. If you need to write more, split into multiple memos with a shared tag (e.g. #project/my-post) and add part numbers.",
+        inputSchema: {
+            content: z.string().min(1).max(13000).describe("Markdown content with #tags. CRITICAL: MUST NOT exceed 13,000 chars. Server hard limit is ~18K but stay under 13K to avoid errors. Split longer content into multiple memos sharing a #parent-tag."),
+            visibility: visibilityEnum.optional().describe("Visibility (default: configured default)"),
+            createTime: z.string().optional().describe("Backdate. ISO 8601."),
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+    }, async ({ content, visibility, createTime }) => {
+        const body = {
+            content,
+            visibility: visibility ?? options.defaultVisibility,
+        };
+        if (createTime)
+            body.createTime = parseToRFC3339(createTime, "createTime");
+        const memo = await client.post("/api/v1/memos", body);
+        const name = memo.name;
+        if (!name)
+            throw new Error("Create failed: no memo name in response");
+        const match = name.match(/^memos\/(.+)$/);
+        const memoId = match?.[1];
+        if (!memoId)
+            throw new Error(`Create failed: unexpected name format: ${name}`);
+        return { content: [{ type: "text", text: JSON.stringify({ name: memo.name, visibility: memo.visibility, url: `${client.baseUrl}/memos/${memoId}` }) }] };
+    });
+    // update — modify an existing memo
+    server.registerTool("update", {
+        description: "Update memo fields. Only provided fields are changed.",
+        inputSchema: {
+            id: z.string().min(1).describe("Memo ID or UID"),
+            content: z.string().max(13000).optional().describe("New markdown content. CRITICAL: MUST NOT exceed 13,000 chars. Server hard limit is ~18K but stay under 13K."),
+            visibility: visibilityEnum.optional().describe("New visibility"),
+            pinned: z.boolean().optional().describe("Pin/unpin"),
+            state: z.enum(["NORMAL", "ARCHIVED"]).optional().describe("Archive/restore"),
+            createTime: z.string().optional().describe("Override creation time. ISO 8601."),
+            updateTime: z.string().optional().describe("Override update time. ISO 8601."),
+            preserveUpdateTime: z.boolean().optional().describe("Don't change update time"),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ id, content, visibility, pinned, state, createTime, updateTime, preserveUpdateTime }) => {
+        const memoId = await resolveToMemoId(client, id);
+        const body = {};
+        const mask = [];
+        if (content !== undefined) {
+            body.content = content;
+            mask.push("content");
+        }
+        if (visibility !== undefined) {
+            body.visibility = visibility;
+            mask.push("visibility");
+        }
+        if (pinned !== undefined) {
+            body.pinned = pinned;
+            mask.push("pinned");
+        }
+        if (state !== undefined) {
+            body.rowStatus = state === "ARCHIVED" ? "ARCHIVED" : "ACTIVE";
+            mask.push("row_status");
+        }
+        if (createTime !== undefined) {
+            body.createTime = parseToRFC3339(createTime, "createTime");
+            mask.push("create_time");
+        }
+        if (updateTime !== undefined) {
+            body.updateTime = parseToRFC3339(updateTime, "updateTime");
+            mask.push("update_time");
+        }
+        if (mask.length === 0)
+            return { content: [{ type: "text", text: "No fields to update." }] };
+        const params = { updateMask: mask.join(",") };
+        if (preserveUpdateTime)
+            params.preserveUpdateTime = "true";
+        await client.patch(`/api/v1/memos/${memoId}`, body, params);
+        const updatedMemo = await client.get(`/api/v1/memos/${memoId}`);
+        const cleaned = cleanMemo(updatedMemo, client.baseUrl);
+        return { content: [{ type: "text", text: JSON.stringify(cleaned, null, 2) }] };
+    });
+    // delete — remove a memo
+    server.registerTool("delete", {
+        description: "Permanently delete a memo. Cannot be undone.",
+        inputSchema: {
+            id: z.string().min(1).describe("Memo ID or UID"),
+        },
+        annotations: { destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ id }) => {
+        const memo = await client.get(`/api/v1/memos/${id}`);
+        const memoId = await resolveToMemoId(client, id);
+        await client.delete(`/api/v1/memos/${memoId}`);
+        return { content: [{ type: "text", text: JSON.stringify({ deleted: true, name: memo.name, snippet: memo.snippet?.substring(0, 100) }) }] };
+    });
+};
+//# sourceMappingURL=memos.js.map

package/dist/tools/memos.js.map

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

package/dist/tools/relations.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MemosClient } from "../client.js";
+export declare const registerRelationTools: (server: McpServer, client: MemosClient) => void;
+//# sourceMappingURL=relations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../src/tools/relations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAwD3C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SA2F3E,CAAC"}

package/dist/tools/relations.js

@@ -0,0 +1,108 @@
+import { z } from "zod";
+import { resolveToMemoId } from "./utils.js";
+function extractId(memoRef) {
+    const name = typeof memoRef === "string" ? memoRef : memoRef?.name;
+    if (!name || typeof name !== "string")
+        return undefined;
+    const match = name.match(/^memos\/(.+)$/);
+    return match ? match[1] : undefined;
+}
+async function buildRelationGraph(client, startId, maxDepth) {
+    const visited = new Set();
+    const edges = [];
+    const edgeSet = new Set();
+    const queue = [{ id: startId, depth: 0 }];
+    while (queue.length > 0) {
+        const { id, depth } = queue.shift();
+        if (visited.has(id))
+            continue;
+        visited.add(id);
+        const result = await client.get(`/api/v1/memos/${id}/relations`);
+        for (const r of result.relations || []) {
+            const fromId = extractId(r.memo);
+            const toId = extractId(r.relatedMemo);
+            if (fromId === undefined || toId === undefined)
+                continue;
+            const edgeKey = `${fromId}->${toId}:${r.type}`;
+            if (edgeSet.has(edgeKey))
+                continue;
+            edgeSet.add(edgeKey);
+            edges.push({ from: fromId, to: toId, type: r.type });
+            const neighborId = fromId === id ? toId : fromId;
+            if (depth < maxDepth && !visited.has(neighborId)) {
+                queue.push({ id: neighborId, depth: depth + 1 });
+            }
+        }
+    }
+    return { nodes: [...visited], edges };
+}
+export const registerRelationTools = (server, client) => {
+    server.registerTool("list_memo_relations", {
+        description: [
+            "List relations of a memo. Returns edges with direction (from → to) and type.",
+            "- depth=1 (default): direct relations only.",
+            "- depth=2+: recursively expand related memos to build a relation graph.",
+            "Each edge shows {from, to, type}. Use get_memo to inspect specific nodes.",
+        ].join(" "),
+        inputSchema: {
+            id: z.string().min(1).describe("Memo identifier. Numeric ID or UID string"),
+            depth: z.number().int().min(1).max(5).default(1).describe("How many levels deep to traverse. 1 = direct relations, 2+ = recursive graph"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ id, depth }) => {
+        const memoId = await resolveToMemoId(client, id);
+        const { nodes, edges } = await buildRelationGraph(client, memoId, depth);
+        if (edges.length === 0) {
+            return { content: [{ type: "text", text: "No relations found." }] };
+        }
+        const output = { startNode: memoId, nodes, edges };
+        return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
+    });
+    server.registerTool("set_memo_relations", {
+        description: [
+            "Add or remove REFERENCE relations for a memo.",
+            "- action=\"add\": add new references without affecting existing ones.",
+            "- action=\"remove\": remove specific references.",
+            "Note: COMMENT relations are managed by the system and cannot be modified here.",
+        ].join(" "),
+        inputSchema: {
+            id: z.string().min(1).describe("Memo identifier. Numeric ID or UID string"),
+            action: z.enum(["add", "remove"]).describe("Whether to add or remove relations"),
+            targetIds: z.array(z.string().min(1)).min(1).describe("IDs of memos to add/remove as references. Numeric IDs or UID strings"),
+        },
+        annotations: { destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    }, async ({ id, action, targetIds }) => {
+        const memoId = await resolveToMemoId(client, id);
+        const resolvedTargets = await Promise.all(targetIds.map((t) => resolveToMemoId(client, t)));
+        const current = await client.get(`/api/v1/memos/${memoId}/relations`);
+        const existing = (current.relations || []).filter((r) => extractId(r.memo) === memoId && r.type === "REFERENCE");
+        let finalIds;
+        if (action === "add") {
+            const existingIds = new Set(existing.map((r) => extractId(r.relatedMemo)).filter((id) => id !== undefined));
+            finalIds = [
+                ...existing.map((r) => extractId(r.relatedMemo)).filter((id) => id !== undefined),
+                ...resolvedTargets.filter((t) => !existingIds.has(t)),
+            ];
+        }
+        else {
+            const removeSet = new Set(resolvedTargets);
+            finalIds = existing
+                .map((r) => extractId(r.relatedMemo))
+                .filter((id) => id !== undefined)
+                .filter((rid) => !removeSet.has(rid));
+        }
+        const body = {
+            relations: finalIds.map((targetId) => ({
+                memo: { name: `memos/${memoId}` },
+                relatedMemo: { name: `memos/${targetId}` },
+                type: "REFERENCE",
+            })),
+        };
+        await client.patch(`/api/v1/memos/${memoId}/relations`, body);
+        const verb = action === "add" ? "added" : "removed";
+        return {
+            content: [{ type: "text", text: `${resolvedTargets.length} reference(s) ${verb}. Memo ${id} now has ${finalIds.length} outgoing reference(s).` }],
+        };
+    });
+};
+//# sourceMappingURL=relations.js.map

package/dist/tools/relations.js.map

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

package/dist/tools/resources.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MemosClient } from "../client.js";
+export declare const registerResourceTools: (server: McpServer, client: MemosClient) => void;
+//# sourceMappingURL=resources.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/tools/resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkB3C,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SAkE3E,CAAC"}

package/dist/tools/resources.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+function summarizeResource(res) {
+    const name = res.name;
+    const id = name?.match(/^resources\/(\d+)$/)?.[1];
+    const summary = {
+        id: id ? Number(id) : undefined,
+        uid: res.uid,
+        filename: res.filename,
+        type: res.type,
+        size: res.size,
+    };
+    if (res.externalLink)
+        summary.externalLink = res.externalLink;
+    if (res.memo)
+        summary.memo = res.memo;
+    return summary;
+}
+export const registerResourceTools = (server, client) => {
+    server.registerTool("list_resources", {
+        description: "List all resources (attachments) owned by the current user.",
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async () => {
+        const result = await client.get("/api/v1/resources");
+        const summaries = (result.resources || []).map((r) => summarizeResource(r));
+        return { content: [{ type: "text", text: JSON.stringify(summaries, null, 2) }] };
+    });
+    server.registerTool("upload_resource", {
+        description: "Upload a file as a resource. The file content must be base64 encoded. Optionally link it to a memo.",
+        inputSchema: {
+            filename: z.string().min(1).describe("File name with extension, e.g. \"photo.jpg\""),
+            contentBase64: z.string().min(1).describe("File content as a base64 encoded string"),
+            type: z.string().optional().describe("MIME type, e.g. \"image/jpeg\". Auto-detected from extension if omitted"),
+            memoId: z.number().int().optional().describe("Memo ID to link this resource to"),
+        },
+        annotations: { destructiveHint: false, openWorldHint: false },
+    }, async ({ filename, contentBase64, type, memoId }) => {
+        const mimeType = type ?? guessMimeType(filename);
+        const body = {
+            filename,
+            content: contentBase64,
+            type: mimeType,
+        };
+        if (memoId !== undefined) {
+            body.memo = `memos/${memoId}`;
+        }
+        const resource = await client.post("/api/v1/resources", body);
+        const id = resource.name?.match(/^resources\/(.+)$/)?.[1];
+        const resFilename = resource.filename || "unknown";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Resource uploaded: id=${id || "unknown"}, filename="${resFilename}"`,
+                },
+            ],
+        };
+    });
+    server.registerTool("delete_resource", {
+        description: "Delete a resource permanently.",
+        inputSchema: {
+            id: z.number().int().describe("Resource ID"),
+        },
+        annotations: { destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    }, async ({ id }) => {
+        await client.delete(`/api/v1/resources/${id}`);
+        return { content: [{ type: "text", text: `Resource ${id} deleted.` }] };
+    });
+};
+const MIME_MAP = {
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    png: "image/png",
+    gif: "image/gif",
+    webp: "image/webp",
+    svg: "image/svg+xml",
+    pdf: "application/pdf",
+    mp3: "audio/mpeg",
+    mp4: "video/mp4",
+    webm: "video/webm",
+    txt: "text/plain",
+    md: "text/markdown",
+    json: "application/json",
+    csv: "text/csv",
+    zip: "application/zip",
+};
+function guessMimeType(filename) {
+    const ext = filename.split(".").pop()?.toLowerCase() ?? "";
+    return MIME_MAP[ext] ?? "application/octet-stream";
+}
+//# sourceMappingURL=resources.js.map

package/dist/tools/resources.js.map

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

package/dist/tools/review.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MemosClient } from "../client.js";
+export declare const registerSearchTool: (server: McpServer, client: MemosClient) => void;
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAkE3C,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SA4GxE,CAAC"}