mcp-for-memos 1.0.0

package/dist/tools/review.js

@@ -0,0 +1,208 @@
+import { z } from "zod";
+import { summarizeMemo } from "./utils.js";
+function escapeCel(str) {
+    return str.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function parseRelativeDate(input) {
+    const now = new Date();
+    const lower = input.toLowerCase().trim();
+    const toMidnight = (d) => { d.setUTCHours(0, 0, 0, 0); return d; };
+    if (lower === "today")
+        return toMidnight(new Date(now));
+    if (lower === "tomorrow") {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() + 1);
+        return toMidnight(d);
+    }
+    if (lower === "yesterday") {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() - 1);
+        return toMidnight(d);
+    }
+    if (lower === "next_week") {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() + 7);
+        return toMidnight(d);
+    }
+    if (lower === "last_week") {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() - 7);
+        return toMidnight(d);
+    }
+    if (lower === "this_week")
+        return toMidnight(new Date(now));
+    if (lower === "next_month") {
+        const d = new Date(now);
+        d.setUTCMonth(d.getUTCMonth() + 1);
+        return toMidnight(d);
+    }
+    if (lower === "last_month") {
+        const d = new Date(now);
+        d.setUTCMonth(d.getUTCMonth() - 1);
+        return toMidnight(d);
+    }
+    if (lower === "this_month")
+        return toMidnight(new Date(now));
+    const dayNames = ["sunday", "monday", "tuesday", "wednesday", "thursday", "friday", "saturday"];
+    const nextDayMatch = lower.match(/^next_(sunday|monday|tuesday|wednesday|thursday|friday|saturday)$/);
+    if (nextDayMatch) {
+        const targetDay = dayNames.indexOf(nextDayMatch[1]);
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() + ((targetDay - d.getUTCDay() + 7) % 7 || 7));
+        return toMidnight(d);
+    }
+    const lastDayMatch = lower.match(/^last_(sunday|monday|tuesday|wednesday|thursday|friday|saturday)$/);
+    if (lastDayMatch) {
+        const targetDay = dayNames.indexOf(lastDayMatch[1]);
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() - ((d.getUTCDay() - targetDay + 7) % 7 || 7));
+        return toMidnight(d);
+    }
+    const daysAgoMatch = lower.match(/^(\d+)_days_ago$/);
+    if (daysAgoMatch) {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() - parseInt(daysAgoMatch[1]));
+        return toMidnight(d);
+    }
+    const inDaysMatch = lower.match(/^in_(\d+)_days$/);
+    if (inDaysMatch) {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() + parseInt(inDaysMatch[1]));
+        return toMidnight(d);
+    }
+    const weeksAgoMatch = lower.match(/^(\d+)_weeks_ago$/);
+    if (weeksAgoMatch) {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() - parseInt(weeksAgoMatch[1]) * 7);
+        return toMidnight(d);
+    }
+    const inWeeksMatch = lower.match(/^in_(\d+)_weeks$/);
+    if (inWeeksMatch) {
+        const d = new Date(now);
+        d.setUTCDate(d.getUTCDate() + parseInt(inWeeksMatch[1]) * 7);
+        return toMidnight(d);
+    }
+    const parsed = new Date(input);
+    if (!isNaN(parsed.getTime()))
+        return parsed;
+    throw new Error(`Cannot parse date: "${input}". Use ISO 8601, "today", "yesterday", "next_monday", "3_days_ago", etc.`);
+}
+function getWeekBoundaries(refDate) {
+    const d = new Date(refDate);
+    const day = d.getUTCDay();
+    const diffToMonday = (day === 0 ? -6 : 1) - day;
+    const start = new Date(d);
+    start.setUTCDate(d.getUTCDate() + diffToMonday);
+    start.setUTCHours(0, 0, 0, 0);
+    const end = new Date(start);
+    end.setUTCDate(start.getUTCDate() + 6);
+    end.setUTCHours(23, 59, 59, 999);
+    return { start, end };
+}
+export const registerSearchTool = (server, client) => {
+    server.registerTool("search", {
+        description: [
+            "Search memos. Unified tool for date-based, tag-based, and content-based search.",
+            "",
+            "Date (optional, accepts):",
+            "  ISO: '2025-06-15'  |  Relative: 'today', 'yesterday', 'tomorrow'",
+            "  Relative: 'next_monday', 'last_friday', 'next_week', 'this_month'",
+            "  Relative: 'in_7_days', '3_days_ago', 'in_2_weeks'",
+            "  week=true: auto full week (Mon-Sun)",
+            "",
+            "Filters (all optional, combined with AND):",
+            "  tags: ['work', 'meeting']  |  query: 'text search'",
+            "  visibility: ['PRIVATE']     |  pinned: true",
+            "  state: 'ARCHIVED'           |  hasIncompleteTasks: true",
+            "  hasAttachments: true        |  Only memos with file attachments",
+            "",
+            "No date = all memos. No filters = all memos.",
+        ].join("\n"),
+        inputSchema: {
+            date: z.string().optional().describe("Date (ISO 8601 or relative). Omit to search all memos."),
+            endDate: z.string().optional().describe("End date for range. Omit for single-day."),
+            week: z.boolean().optional().describe("Auto full week (Mon-Sun) around date"),
+            tags: z.array(z.string()).optional().describe("Filter by tags"),
+            query: z.string().optional().describe("Full-text search in content"),
+            visibility: z.array(z.enum(["PRIVATE", "PROTECTED", "PUBLIC"])).optional().describe("Filter by visibility"),
+            pinned: z.boolean().optional().describe("Only pinned memos"),
+            state: z.enum(["NORMAL", "ARCHIVED"]).optional().describe("Filter by state"),
+            hasIncompleteTasks: z.boolean().optional().describe("Only memos with incomplete tasks"),
+            hasAttachments: z.boolean().optional().describe("Only memos with file attachments"),
+            pageSize: z.number().int().min(1).max(100).default(20).describe("Results per page"),
+            pageToken: z.string().optional().describe("Pagination token"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async (args) => {
+        let currentUser;
+        try {
+            currentUser = await client.getCurrentUser();
+        }
+        catch {
+            currentUser = "";
+        }
+        // Build CEL filter
+        const parts = [];
+        if (currentUser)
+            parts.push(`creator == "${escapeCel(currentUser)}"`);
+        // Date filtering
+        if (args.date) {
+            try {
+                const refDate = parseRelativeDate(args.date);
+                let startTs;
+                let endTs;
+                if (args.week) {
+                    const b = getWeekBoundaries(refDate);
+                    startTs = Math.floor(b.start.getTime() / 1000);
+                    endTs = Math.floor(b.end.getTime() / 1000);
+                }
+                else {
+                    startTs = Math.floor(refDate.getTime() / 1000);
+                    endTs = args.endDate ? Math.floor(parseRelativeDate(args.endDate).getTime() / 1000) : startTs + 86400;
+                }
+                parts.push(`created_ts >= ${startTs}`);
+                parts.push(`created_ts <= ${endTs}`);
+            }
+            catch (e) {
+                return { content: [{ type: "text", text: String(e) }] };
+            }
+        }
+        // Other filters
+        if (args.tags?.length) {
+            const tagList = args.tags.map((t) => `"${escapeCel(t)}"`).join(", ");
+            parts.push(`tag in [${tagList}]`);
+        }
+        if (args.query)
+            parts.push(`content.contains("${escapeCel(args.query)}")`);
+        if (args.visibility?.length) {
+            const visList = args.visibility.map((v) => `"${v}"`).join(", ");
+            parts.push(`visibility in [${visList}]`);
+        }
+        if (args.pinned !== undefined)
+            parts.push(`pinned == ${args.pinned}`);
+        if (args.state)
+            parts.push(`row_status == "${args.state === "ARCHIVED" ? "ARCHIVED" : "NORMAL"}"`);
+        if (args.hasIncompleteTasks)
+            parts.push(`has_incomplete_tasks == true`);
+        const filter = parts.length > 0 ? parts.join(" && ") : "";
+        const params = {
+            pageSize: String(args.pageSize),
+            orderBy: "create_time desc",
+        };
+        if (filter)
+            params.filter = filter;
+        if (args.pageToken)
+            params.pageToken = args.pageToken;
+        const result = await client.get("/api/v1/memos", params);
+        let summaries = (result.memos || []).map((m) => summarizeMemo(m));
+        // Filter by attachments count (post-fetch since Memos API doesn't support this in CEL)
+        if (args.hasAttachments) {
+            summaries = summaries.filter((s) => s.attachmentsCount > 0);
+        }
+        const output = { memos: summaries, totalFound: summaries.length };
+        if (result.nextPageToken)
+            output.nextPageToken = result.nextPageToken;
+        return { content: [{ type: "text", text: JSON.stringify(output, null, 2) }] };
+    });
+};
+//# sourceMappingURL=review.js.map

package/dist/tools/review.js.map

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

package/dist/tools/tags.d.ts

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

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

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

package/dist/tools/tags.js

@@ -0,0 +1,164 @@
+import { z } from "zod";
+const tagsCache = new Map();
+const TAGS_CACHE_TTL_MS = 60_000; // 1 minuto
+const TAGS_MAX_PAGES = 20; // Máximo 20 páginas (10,000 memos) para evitar fetch infinito
+// Sweep periódico del cache
+setInterval(() => {
+    const now = Date.now();
+    for (const [key, entry] of tagsCache) {
+        if (now - entry.timestamp > TAGS_CACHE_TTL_MS) {
+            tagsCache.delete(key);
+        }
+    }
+}, 30_000);
+function getCachedTags(key) {
+    const entry = tagsCache.get(key);
+    if (!entry)
+        return null;
+    if (Date.now() - entry.timestamp > TAGS_CACHE_TTL_MS) {
+        tagsCache.delete(key);
+        return null;
+    }
+    return entry.tagCounts;
+}
+function setCachedTags(key, tagCounts) {
+    tagsCache.set(key, { tagCounts, timestamp: Date.now() });
+}
+function hasChildTags(allTags, tagName) {
+    const prefix = tagName + "/";
+    for (const tag of allTags) {
+        if (tag.startsWith(prefix) && tag !== tagName)
+            return true;
+    }
+    return false;
+}
+function getTopLevelTags(tagCounts) {
+    const allTags = new Set(tagCounts.keys());
+    const result = [];
+    for (const [name, count] of tagCounts) {
+        if (!name.includes("/")) {
+            result.push({ name, count, hasChildren: hasChildTags(allTags, name) });
+        }
+    }
+    return result.sort((a, b) => b.count - a.count || a.name.localeCompare(b.name));
+}
+function getChildTags(tagCounts, parent) {
+    const allTags = new Set(tagCounts.keys());
+    const prefix = parent + "/";
+    const result = [];
+    const seen = new Set();
+    for (const tag of allTags) {
+        if (tag.startsWith(prefix) && tag !== parent) {
+            const remainder = tag.slice(prefix.length);
+            const firstChild = remainder.split("/")[0];
+            const childTag = prefix + firstChild;
+            if (!seen.has(childTag)) {
+                seen.add(childTag);
+                let totalCount = 0;
+                for (const t of allTags) {
+                    if (t === childTag || t.startsWith(childTag + "/")) {
+                        totalCount += tagCounts.get(t) || 0;
+                    }
+                }
+                result.push({
+                    name: childTag,
+                    count: totalCount,
+                    hasChildren: hasChildTags(allTags, childTag),
+                });
+            }
+        }
+    }
+    return result.sort((a, b) => b.count - a.count || a.name.localeCompare(b.name));
+}
+function getAllTags(tagCounts) {
+    const allTagNames = new Set(tagCounts.keys());
+    const result = [];
+    for (const [name, count] of tagCounts) {
+        result.push({
+            name,
+            count,
+            hasChildren: name.includes("/") ? false : hasChildTags(allTagNames, name),
+        });
+    }
+    return result.sort((a, b) => b.count - a.count || a.name.localeCompare(b.name));
+}
+// Fetch tags del usuario con cache y límite de páginas
+async function fetchTagsForUser(client) {
+    const currentUser = await client.getCurrentUser();
+    const cacheKey = `tags:${currentUser}`;
+    const cached = getCachedTags(cacheKey);
+    if (cached)
+        return cached;
+    const tagCounts = new Map();
+    let pageToken;
+    let pageCount = 0;
+    do {
+        const params = {
+            pageSize: "500",
+            filter: `creator == "${currentUser}"`,
+        };
+        if (pageToken)
+            params.pageToken = pageToken;
+        const result = await client.get("/api/v1/memos", params);
+        if (result.memos) {
+            for (const memo of result.memos) {
+                for (const tag of memo.tags ?? []) {
+                    tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1);
+                }
+            }
+        }
+        pageToken = result.nextPageToken;
+        pageCount++;
+        // Límite de seguridad para evitar fetch infinito
+        if (pageCount >= TAGS_MAX_PAGES)
+            break;
+    } while (pageToken);
+    setCachedTags(cacheKey, tagCounts);
+    return tagCounts;
+}
+export const registerTagTools = (server, client) => {
+    server.registerTool("tags", {
+        description: [
+            "List tags with usage counts extracted from your memo content.",
+            "Tags are hashtags like #project or #work/meeting in your memos.",
+            "Results are cached for 60 seconds.",
+            "",
+            "Usage modes:",
+            "- No args: top-level tags only (e.g. 'project', 'work')",
+            "- parent='work': children of 'work' (e.g. 'work/meeting', 'work/notes')",
+            "- recursive=true: all tags flat (useful for tag recommendations)",
+        ].join("\n"),
+        inputSchema: {
+            parent: z.string().optional().describe("Parent tag to filter children. E.g. 'project' to see 'project/backend', 'project/frontend'"),
+            recursive: z.boolean().optional().describe("Return ALL tags including nested ones"),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, async ({ parent, recursive }) => {
+        const tagCounts = await fetchTagsForUser(client);
+        if (tagCounts.size === 0) {
+            return {
+                content: [{ type: "text", text: "No tags found in your memos." }],
+            };
+        }
+        let results;
+        if (recursive) {
+            results = getAllTags(tagCounts);
+        }
+        else if (parent) {
+            results = getChildTags(tagCounts, parent);
+        }
+        else {
+            results = getTopLevelTags(tagCounts);
+        }
+        if (results.length === 0) {
+            const msg = parent
+                ? `No child tags found under "${parent}".`
+                : "No tags found.";
+            return { content: [{ type: "text", text: msg }] };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+        };
+    });
+};
+//# sourceMappingURL=tags.js.map

package/dist/tools/tags.js.map

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

package/dist/tools/utils.d.ts

@@ -0,0 +1,6 @@
+import { MemosClient } from "../client.js";
+export declare const SNIPPET_MAX_LENGTH = 200;
+export declare function compactProperty(property: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
+export declare function summarizeMemo(memo: Record<string, unknown>): Record<string, unknown>;
+export declare function resolveToMemoId(client: MemosClient, id: string): Promise<string>;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,uCAQ5E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,2BAuC1D;AAID,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAetF"}

package/dist/tools/utils.js

@@ -0,0 +1,68 @@
+export const SNIPPET_MAX_LENGTH = 200;
+export function compactProperty(property) {
+    if (!property)
+        return undefined;
+    const truthy = {};
+    for (const [k, v] of Object.entries(property)) {
+        // Only include truthy properties to reduce noise
+        if (v)
+            truthy[k] = v;
+    }
+    return Object.keys(truthy).length > 0 ? truthy : undefined;
+}
+export function summarizeMemo(memo) {
+    // Usar el snippet del memo si existe, de lo contrario generar uno del contenido
+    let snippet = memo.snippet;
+    if (!snippet) {
+        const content = memo.content || "";
+        snippet = content.length > SNIPPET_MAX_LENGTH
+            ? content.slice(0, SNIPPET_MAX_LENGTH) + "..."
+            : content;
+    }
+    const name = memo.name;
+    // Extract UID from name field (format: "memos/uid")
+    const uid = name?.match(/^memos\/(.+)$/)?.[1] || "";
+    const summary = {
+        name: name,
+        uid: uid,
+        createTime: memo.createTime,
+        snippet,
+        tags: memo.tags,
+        visibility: memo.visibility,
+    };
+    if (memo.updateTime && memo.updateTime !== memo.createTime) {
+        summary.updateTime = memo.updateTime;
+    }
+    if (memo.pinned)
+        summary.pinned = true;
+    const property = compactProperty(memo.property);
+    if (property)
+        summary.property = property;
+    // Include attachments count if present
+    const attachments = memo.attachments;
+    if (Array.isArray(attachments) && attachments.length > 0) {
+        summary.attachmentsCount = attachments.length;
+    }
+    return summary;
+}
+// Resolver un memo ID a su identifier usable en la API
+// Memos 0.29.1 usa UIDs (memos/abc123) en vez de IDs numéricos
+export async function resolveToMemoId(client, id) {
+    // Si ya es numérico, usarlo directo
+    if (/^\d+$/.test(id)) {
+        return id;
+    }
+    // Si ya parece un UID (letras + números, largo > 5), usarlo directo
+    if (/^[a-zA-Z0-9_-]{6,}$/.test(id)) {
+        return id;
+    }
+    // Intentar buscar por el path completo
+    const memo = await client.get(`/api/v1/memos/${id}`);
+    if (!memo?.name)
+        throw new Error(`Memo not found: ${id}`);
+    const match = memo.name.match(/^memos\/(.+)$/);
+    if (!match)
+        throw new Error(`Unexpected memo name format: ${memo.name}`);
+    return match[1];
+}
+//# sourceMappingURL=utils.js.map

package/dist/tools/utils.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,36 @@
+export declare const VALID_VISIBILITIES: readonly ["PRIVATE", "PROTECTED", "PUBLIC"];
+export type Visibility = (typeof VALID_VISIBILITIES)[number];
+export interface Attachment {
+    name: string;
+    filename: string;
+    type: string;
+    size: string;
+    createTime: string;
+    externalLink?: string;
+    uiResourcePath?: string;
+}
+export interface Memo {
+    name: string;
+    uid: string;
+    rowStatus: string;
+    creator: string;
+    createTime: string;
+    updateTime: string;
+    content: string;
+    visibility: Visibility;
+    tags: string[];
+    pinned: boolean;
+    attachments: Attachment[];
+    relations: unknown[];
+    reactions: unknown[];
+    property?: MemoProperty;
+    parent?: string;
+    snippet?: string;
+}
+export interface MemoProperty {
+    hasLink: boolean;
+    hasTaskList: boolean;
+    hasCode: boolean;
+    hasIncompleteTasks: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,6CAA8C,CAAC;AAC9E,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;CAC7B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const VALID_VISIBILITIES = ["PRIVATE", "PROTECTED", "PUBLIC"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "mcp-for-memos",
+  "version": "1.0.0",
+  "description": "MCP server that turns Memos into a multi-purpose database for AI — notes, projects, tasks, agendas, knowledge base. Supports HTTP/SSE multi-tenant access.",
+  "type": "module",
+  "bin": {
+    "mcp-for-memos": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "dev:http": "tsx src/index.ts --http",
+    "start": "node dist/index.js",
+    "start:http": "node dist/index.js --http",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "memos",
+    "note-taking",
+    "sse",
+    "http",
+    "multi-tenant"
+  ],
+  "author": "guzman-lopez",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CesarGuzmanLopez/memos-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "express": "^5.2.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.9.2",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}