mcp-for-memos 1.0.0

package/dist/http.js

@@ -0,0 +1,342 @@
+import express from "express";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { createServerWithClient } from "./server.js";
+import { MemosClient } from "./client.js";
+import { getCorsOrigins } from "./config.js";
+// Logger simple
+function log(level, message, meta) {
+    const timestamp = new Date().toISOString();
+    const metaStr = meta ? ` ${JSON.stringify(meta)}` : "";
+    console.log(`[${timestamp}] [${level.toUpperCase()}] ${message}${metaStr}`);
+}
+// Extraer Bearer token del header Authorization
+function extractBearerToken(req) {
+    const authHeader = req.headers.authorization;
+    if (!authHeader || !authHeader.startsWith("Bearer ")) {
+        return null;
+    }
+    return authHeader.slice(7);
+}
+// Rate limiting configuration
+const RATE_LIMIT_WINDOW_MS = 60_000; // 1 minute
+const RATE_LIMIT_MAX_REQUESTS = 100; // 100 requests per minute per IP
+const rateLimitMap = new Map();
+// Sweep de rate limit cada 30 segundos
+setInterval(() => {
+    const now = Date.now();
+    for (const [key, entry] of rateLimitMap) {
+        if (now - entry.timestamp > RATE_LIMIT_WINDOW_MS) {
+            rateLimitMap.delete(key);
+        }
+    }
+}, 30_000);
+// Rate limiting middleware
+function rateLimit(req, res, next) {
+    const ip = req.ip || req.socket.remoteAddress || "unknown";
+    const now = Date.now();
+    const entry = rateLimitMap.get(ip);
+    if (!entry || now - entry.timestamp > RATE_LIMIT_WINDOW_MS) {
+        rateLimitMap.set(ip, { count: 1, timestamp: now });
+        next();
+        return;
+    }
+    if (entry.count >= RATE_LIMIT_MAX_REQUESTS) {
+        res.status(429).json({ error: "Too many requests. Try again later." });
+        return;
+    }
+    entry.count++;
+    next();
+}
+// Configuración de SSE sessions
+const SSE_IDLE_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutos
+const SSE_MAX_SESSIONS = 100;
+// Map para mantener sesiones SSE activas
+const sseSessions = new Map();
+// Sweep de sesiones SSE idle
+function sweepIdleSessions() {
+    const now = Date.now();
+    for (const [id, session] of sseSessions) {
+        if (now - session.lastActivity > SSE_IDLE_TIMEOUT_MS) {
+            log("info", "Closing idle SSE session", { sessionId: id });
+            session.transport.close();
+            sseSessions.delete(id);
+        }
+    }
+}
+// Sweep cada 30 segundos
+setInterval(sweepIdleSessions, 30_000);
+// Crear aplicación Express
+export function createHttpApp(config) {
+    const app = express();
+    // Middleware
+    app.use(express.json({ limit: "10mb" }));
+    // Request ID middleware
+    app.use((req, _res, next) => {
+        req.requestId = Math.random().toString(36).slice(2, 11);
+        next();
+    });
+    // Logging middleware
+    app.use((req, res, next) => {
+        const requestId = req.requestId;
+        log("info", `${req.method} ${req.path}`, { requestId, ip: req.ip });
+        next();
+    });
+    // CORS
+    const corsOrigins = getCorsOrigins(config);
+    app.use((req, res, next) => {
+        const origin = req.headers.origin;
+        if (origin && (corsOrigins.includes("*") || corsOrigins.includes(origin))) {
+            res.setHeader("Access-Control-Allow-Origin", origin);
+        }
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, MCT-PROXY-VERSION");
+        if (req.method === "OPTIONS") {
+            res.sendStatus(200);
+            return;
+        }
+        next();
+    });
+    // Rate limiting
+    app.use(rateLimit);
+    // Health check endpoint
+    app.get("/health", (_req, res) => {
+        const uptime = process.uptime();
+        const memUsage = process.memoryUsage();
+        res.json({
+            status: "ok",
+            timestamp: new Date().toISOString(),
+            version: "3.0.0",
+            activeSessions: sseSessions.size,
+            uptime: Math.floor(uptime),
+            memory: {
+                rss: Math.floor(memUsage.rss / 1024 / 1024),
+                heapUsed: Math.floor(memUsage.heapUsed / 1024 / 1024),
+                heapTotal: Math.floor(memUsage.heapTotal / 1024 / 1024),
+            },
+        });
+    });
+    // HEAD request for MCP discovery (no auth required for protocol discovery)
+    app.head("/mcp", (_req, res) => {
+        res.setHeader("Content-Type", "application/json");
+        res.status(200).end();
+    });
+    // Streamable HTTP endpoint (moderno) - POST
+    app.post("/mcp", async (req, res) => {
+        const requestId = req.requestId;
+        const token = extractBearerToken(req);
+        if (!token) {
+            log("warn", "Missing or invalid Authorization header", { requestId });
+            res.status(401).json({ error: "Missing or invalid Authorization header. Use: Authorization: Bearer <token>" });
+            return;
+        }
+        if (!config.MEMOS_URL) {
+            log("error", "MEMOS_URL not configured");
+            res.status(500).json({ error: "Server configuration error: MEMOS_URL not set" });
+            return;
+        }
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined, // Stateless
+        });
+        const client = new MemosClient(config.MEMOS_URL, token);
+        const server = createServerWithClient(client);
+        let cleanedUp = false;
+        const cleanup = () => {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            try {
+                transport.close();
+            }
+            catch { }
+            try {
+                server.close();
+            }
+            catch { }
+        };
+        try {
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+            res.on("close", cleanup);
+        }
+        catch (error) {
+            log("error", "Error handling MCP request", { requestId, error: String(error) });
+            cleanup();
+            if (!res.headersSent) {
+                res.status(500).json({ error: "Internal server error" });
+            }
+        }
+    });
+    // Streamable HTTP endpoint - GET
+    app.get("/mcp", async (req, res) => {
+        const requestId = req.requestId;
+        const token = extractBearerToken(req);
+        if (!token) {
+            res.status(401).json({ error: "Missing or invalid Authorization header" });
+            return;
+        }
+        if (!config.MEMOS_URL) {
+            res.status(500).json({ error: "Server configuration error: MEMOS_URL not set" });
+            return;
+        }
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        const client = new MemosClient(config.MEMOS_URL, token);
+        const server = createServerWithClient(client);
+        let cleanedUp = false;
+        const cleanup = () => {
+            if (cleanedUp)
+                return;
+            cleanedUp = true;
+            try {
+                transport.close();
+            }
+            catch { }
+            try {
+                server.close();
+            }
+            catch { }
+        };
+        try {
+            await server.connect(transport);
+            await transport.handleRequest(req, res);
+            res.on("close", cleanup);
+        }
+        catch (error) {
+            log("error", "Error in MCP GET", { requestId, error: String(error) });
+            cleanup();
+            if (!res.headersSent) {
+                res.status(500).json({ error: "Internal server error" });
+            }
+        }
+    });
+    // SSE endpoint - GET para iniciar stream
+    app.get("/sse", async (req, res) => {
+        const requestId = req.requestId;
+        const token = extractBearerToken(req);
+        if (!token) {
+            res.status(401).json({ error: "Missing or invalid Authorization header" });
+            return;
+        }
+        if (!config.MEMOS_URL) {
+            res.status(500).json({ error: "Server configuration error: MEMOS_URL not set" });
+            return;
+        }
+        // Verificar límite de sesiones
+        if (sseSessions.size >= SSE_MAX_SESSIONS) {
+            log("warn", "SSE session limit reached", { currentSessions: sseSessions.size, requestId });
+            res.status(429).json({ error: "Too many SSE sessions. Try again later." });
+            return;
+        }
+        const transport = new SSEServerTransport("/sse/messages", res);
+        const client = new MemosClient(config.MEMOS_URL, token);
+        const server = createServerWithClient(client);
+        // Guardar sesión
+        sseSessions.set(transport.sessionId, {
+            transport,
+            lastActivity: Date.now(),
+        });
+        // Cleanup cuando se cierra la conexión
+        res.on("close", () => {
+            sseSessions.delete(transport.sessionId);
+            try {
+                transport.close();
+            }
+            catch { }
+            try {
+                server.close();
+            }
+            catch { }
+        });
+        try {
+            await server.connect(transport);
+            transport.start();
+            log("info", "SSE session started", { sessionId: transport.sessionId, requestId });
+        }
+        catch (error) {
+            log("error", "Error starting SSE", { requestId, error: String(error) });
+            sseSessions.delete(transport.sessionId);
+            try {
+                transport.close();
+            }
+            catch { }
+            try {
+                server.close();
+            }
+            catch { }
+        }
+    });
+    // SSE endpoint - POST para recibir mensajes
+    app.post("/sse/messages", async (req, res) => {
+        const sessionId = req.query.sessionId;
+        if (!sessionId) {
+            res.status(400).json({ error: "Missing sessionId query parameter" });
+            return;
+        }
+        const session = sseSessions.get(sessionId);
+        if (!session) {
+            res.status(404).json({ error: "Session not found or expired" });
+            return;
+        }
+        // Actualizar actividad
+        session.lastActivity = Date.now();
+        try {
+            await session.transport.handlePostMessage(req, res, req.body);
+        }
+        catch (error) {
+            log("error", "Error handling SSE message", { sessionId, error: String(error) });
+            if (!res.headersSent) {
+                res.status(500).json({ error: "Internal server error" });
+            }
+        }
+    });
+    // Error handler
+    app.use((err, _req, res, _next) => {
+        log("error", "Unhandled error", { error: err.message, stack: err.stack });
+        if (!res.headersSent) {
+            res.status(500).json({ error: "Internal server error" });
+        }
+    });
+    return app;
+}
+// Iniciar servidor HTTP
+export function startHttpServer(config) {
+    const app = createHttpApp(config);
+    const { HTTP_PORT, HTTP_HOST } = config;
+    const server = app.listen(HTTP_PORT, HTTP_HOST, () => {
+        log("info", `HTTP server started`, {
+            host: HTTP_HOST,
+            port: HTTP_PORT,
+            url: `http://${HTTP_HOST}:${HTTP_PORT}`,
+        });
+        log("info", `Endpoints:`, {
+            health: `GET http://${HTTP_HOST}:${HTTP_PORT}/health`,
+            mcp: `POST http://${HTTP_HOST}:${HTTP_PORT}/mcp`,
+            sse: `GET http://${HTTP_HOST}:${HTTP_PORT}/sse`,
+        });
+    });
+    // Graceful shutdown - cerrar todo limpiamente
+    const shutdown = () => {
+        log("info", "Shutting down HTTP server...");
+        // Cerrar todas las sesiones SSE
+        for (const [id, session] of sseSessions) {
+            session.transport.close();
+            sseSessions.delete(id);
+        }
+        // Cerrar el servidor Express
+        server.close(() => {
+            log("info", "HTTP server stopped");
+            process.exit(0);
+        });
+        // Forzar salida después de 5 segundos
+        setTimeout(() => {
+            log("warn", "Force shutdown after timeout");
+            process.exit(1);
+        }, 5_000);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    return server;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.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,79 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+import { startHttpServer } from "./http.js";
+import { loadConfig } from "./config.js";
+// Detectar modo de ejecución
+const args = process.argv.slice(2);
+const isHttpMode = args.includes("--http") || args.includes("-h");
+const showHelp = args.includes("--help") || args.includes("-?");
+// Parse port argument
+let customPort;
+const portIndex = args.indexOf("--port");
+if (portIndex !== -1 && args[portIndex + 1]) {
+    customPort = parseInt(args[portIndex + 1], 10);
+    if (isNaN(customPort) || customPort < 1 || customPort > 65535) {
+        console.error("Invalid port. Use --port with a number between 1 and 65535.");
+        process.exit(1);
+    }
+}
+// Mostrar ayuda
+if (showHelp) {
+    console.log(`
+memos-mcp - Model Context Protocol server for Memos
+
+Usage:
+  memos-mcp              Start in stdio mode (for Claude Desktop/Code)
+  memos-mcp --http       Start in HTTP/SSE mode (for OpenCode/LibreChat)
+
+Environment variables:
+  MEMOS_URL              Memos instance URL (required)
+
+HTTP mode:
+  No token needed in .env. Each client sends its own token via
+  Authorization: Bearer <token> header. The server uses that token
+  to access Memos as that specific user.
+
+  HTTP_PORT              HTTP server port (default: 3000)
+  HTTP_HOST              HTTP server host (default: 127.0.0.1)
+  CORS_ORIGIN            Allowed CORS origins (default: *)
+  LOG_LEVEL              Log level: debug, info, warn, error (default: info)
+
+Stdio mode:
+  MEMOS_TOKEN            Memos access token (required for stdio only)
+
+Examples:
+  # Claude Desktop/Code (stdio) - token in env
+  MEMOS_URL=https://memos.example.com MEMOS_TOKEN=xxx npx memos-mcp
+
+  # OpenCode/LibreChat (HTTP) - token in client config
+  MEMOS_URL=https://memos.example.com npx memos-mcp --http
+`);
+    process.exit(0);
+}
+// Modo HTTP
+if (isHttpMode) {
+    // Override port if specified via CLI
+    if (customPort) {
+        process.env.HTTP_PORT = String(customPort);
+    }
+    const config = loadConfig();
+    console.log(`Starting memos-mcp in HTTP mode...`);
+    console.log(`Server will accept requests at:`);
+    console.log(`  - http://${config.HTTP_HOST}:${config.HTTP_PORT}/mcp (Streamable HTTP)`);
+    console.log(`  - http://${config.HTTP_HOST}:${config.HTTP_PORT}/sse (SSE)`);
+    console.log(`  - http://${config.HTTP_HOST}:${config.HTTP_PORT}/health (Health check)`);
+    console.log(``);
+    console.log(`Each request must include: Authorization: Bearer <token>`);
+    startHttpServer(config);
+}
+// Modo stdio (default)
+else {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    server.connect(transport).catch((err) => {
+        console.error("Failed to connect transport:", err);
+        process.exit(1);
+    });
+}
+//# 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,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,6BAA6B;AAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAEhE,sBAAsB;AACtB,IAAI,UAA8B,CAAC;AACnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACzC,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;IAC5C,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,KAAK,EAAE,CAAC;QAC9D,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gBAAgB;AAChB,IAAI,QAAQ,EAAE,CAAC;IACb,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Bb,CAAC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,YAAY;AACZ,IAAI,UAAU,EAAE,CAAC;IACf,qCAAqC;IACrC,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,wBAAwB,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,YAAY,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,wBAAwB,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;IACxE,eAAe,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AACD,uBAAuB;KAClB,CAAC;IACJ,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACtC,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/prompts/index.d.ts

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

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,SAqFhD,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+export const registerPrompts = (server) => {
+    // capture — save a thought
+    server.registerPrompt("capture", {
+        description: "Quick-save a thought, note, task, or idea",
+        argsSchema: {
+            content: z.string().describe("The thought or note to save"),
+            tags: z.string().optional().describe("Comma-separated tags (e.g. 'idea,project')"),
+            visibility: z.enum(["PRIVATE", "PROTECTED", "PUBLIC"]).default("PRIVATE"),
+        },
+    }, ({ content, tags, visibility }) => {
+        let memoContent = content;
+        if (tags) {
+            memoContent = `${memoContent}\n\n${tags.split(",").map((t) => `#${t.trim()}`).join(" ")}`;
+        }
+        return {
+            messages: [{
+                    role: "user",
+                    content: { type: "text", text: `Create a memo using the create tool. Visibility: ${visibility}.\n\nContent:\n${memoContent}` },
+                }],
+        };
+    });
+    // review — review memos from a period
+    server.registerPrompt("review", {
+        description: "Review memos from a time period",
+        argsSchema: {
+            period: z.enum(["today", "week", "month", "year"]).default("week"),
+        },
+    }, ({ period }) => {
+        const map = {
+            today: { date: "today" },
+            week: { date: "this_week", week: true },
+            month: { date: "this_month" },
+            year: { date: "2024-01-01", endDate: "2024-12-31" },
+        };
+        const { date, week, endDate } = map[period];
+        const weekArg = week ? ", week=true" : "";
+        const endDateArg = endDate ? `, endDate="${endDate}"` : "";
+        return {
+            messages: [{
+                    role: "user",
+                    content: { type: "text", text: `Review your memos from ${period}.\n\n1. search(date="${date}"${weekArg}${endDateArg})\n2. get(id="<id>") for each memo, one at a time\n3. Wait for user confirmation between each\n4. Summarize when done` },
+                }],
+        };
+    });
+    // on_day — check a specific date
+    server.registerPrompt("on_day", {
+        description: "Check what happened or is planned for a specific date",
+        argsSchema: {
+            date: z.string().describe("Date to check (ISO 8601, 'today', 'yesterday', 'next_monday', etc.)"),
+        },
+    }, ({ date }) => ({
+        messages: [{
+                role: "user",
+                content: { type: "text", text: `Check what happened or is planned for ${date}.\n\nUse: search(date="${date}")\nPresent the memos found.` },
+            }],
+    }));
+    // tag_overview — analyze tags
+    server.registerPrompt("tag_overview", {
+        description: "Analyze your tag system and suggest improvements",
+    }, () => ({
+        messages: [{
+                role: "user",
+                content: { type: "text", text: `Analyze my tag organization.\n\n1. tags() for top-level tags\n2. tags(parent="<tag>") for children\n3. Present: hierarchy, usage, cleanup suggestions` },
+            }],
+    }));
+};
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/resources/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,QAAQ,WAAW,SA8DvE,CAAC"}

package/dist/resources/index.js

@@ -0,0 +1,52 @@
+import { getPromptDefinitions } from "../prompts/index.js";
+export const registerResources = (server, client) => {
+    server.registerResource("memo", "memo://memos/{uid}", { description: "A memo by its UID", mimeType: "text/markdown" }, async (uri) => {
+        const uid = uri.pathname.split("/").pop();
+        if (!uid) {
+            throw new Error("Invalid memo URI: missing UID");
+        }
+        const memo = await client.get(`/api/v1/memos:by-uid/${uid}`);
+        const id = memo.name?.match(/^memos\/(\d+)$/)?.[1];
+        const frontmatter = [
+            "---",
+            id ? `id: ${id}` : null,
+            `uid: ${memo.uid}`,
+            `visibility: ${memo.visibility}`,
+            memo.pinned ? `pinned: true` : null,
+            `created: ${memo.createTime}`,
+            `updated: ${memo.updateTime}`,
+            memo.tags?.length ? `tags: [${memo.tags.join(", ")}]` : null,
+            "---",
+        ]
+            .filter(Boolean)
+            .join("\n");
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: `${frontmatter}\n\n${memo.content}`,
+                },
+            ],
+        };
+    });
+    // Expose prompts as readable resources so the assistant can access them
+    // programmatically (e.g. from channel conversations where slash commands
+    // are not available).
+    const prompts = getPromptDefinitions();
+    for (const [name, prompt] of Object.entries(prompts)) {
+        server.registerResource(`prompt-${name}`, `memo://prompts/${name}`, {
+            description: `Prompt: ${prompt.description}`,
+            mimeType: "text/markdown",
+        }, async (uri) => ({
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: "text/markdown",
+                    text: prompt.text,
+                },
+            ],
+        }));
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/resources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAiB,EAAE,MAAmB,EAAE,EAAE;IAC1E,MAAM,CAAC,gBAAgB,CACrB,MAAM,EACN,oBAAoB,EACpB,EAAE,WAAW,EAAE,mBAAmB,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC/D,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAO,wBAAwB,GAAG,EAAE,CAAC,CAAC;QAEnE,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,WAAW,GAAG;YAClB,KAAK;YACL,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;YACvB,QAAQ,IAAI,CAAC,GAAG,EAAE;YAClB,eAAe,IAAI,CAAC,UAAU,EAAE;YAChC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI;YACnC,YAAY,IAAI,CAAC,UAAU,EAAE;YAC7B,YAAY,IAAI,CAAC,UAAU,EAAE;YAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;YAC5D,KAAK;SACN;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,GAAG,WAAW,OAAO,IAAI,CAAC,OAAO,EAAE;iBAC1C;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,wEAAwE;IACxE,yEAAyE;IACzE,sBAAsB;IACtB,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,gBAAgB,CACrB,UAAU,IAAI,EAAE,EAChB,kBAAkB,IAAI,EAAE,EACxB;YACE,WAAW,EAAE,WAAW,MAAM,CAAC,WAAW,EAAE;YAC5C,QAAQ,EAAE,eAAe;SAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACd,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,eAAe;oBACzB,IAAI,EAAE,MAAM,CAAC,IAAI;iBAClB;aACF;SACF,CAAC,CACH,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}

package/dist/server.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";
+export interface ServerOptions {
+    defaultVisibility?: Visibility;
+}
+export declare const createServerWithClient: (client: MemosClient, options?: ServerOptions) => McpServer;
+export declare const createServer: () => McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C,OAAO,EAAsB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,UAAU,CAAC;CAChC;AAGD,eAAO,MAAM,sBAAsB,GACjC,QAAQ,WAAW,EACnB,UAAS,aAAkB,cAe5B,CAAC;AAGF,eAAO,MAAM,YAAY,iBAqBxB,CAAC"}