obsidian-mcp-pro 1.0.0

package/build/tools/read.js

@@ -0,0 +1,302 @@
+import { z } from "zod";
+import { searchNotes, readNote, listNotes } from "../lib/vault.js";
+import { parseFrontmatter, extractTags } from "../lib/markdown.js";
+import { getDailyNoteConfig } from "../config.js";
+export function registerReadTools(server, vaultPath) {
+    server.registerTool("search_notes", {
+        description: "Full-text search across all notes in the vault",
+        inputSchema: {
+            query: z.string().describe("Search query string"),
+            caseSensitive: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Whether the search should be case sensitive"),
+            maxResults: z
+                .number()
+                .optional()
+                .default(20)
+                .describe("Maximum number of results to return"),
+            folder: z
+                .string()
+                .optional()
+                .describe("Limit search to a specific folder"),
+        },
+    }, async ({ query, caseSensitive, maxResults, folder }) => {
+        try {
+            const results = await searchNotes(vaultPath, query, {
+                caseSensitive,
+                maxResults,
+                folder,
+            });
+            if (results.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No results found for "${query}"`,
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `Found ${results.length} result(s) for "${query}":`,
+                "",
+            ];
+            for (const result of results) {
+                lines.push(`## ${result.relativePath}`);
+                for (const match of result.matches) {
+                    lines.push(`  Line ${match.line}: ${match.content}`);
+                }
+                lines.push("");
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            console.error("search_notes error:", err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error searching notes: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.registerTool("get_note", {
+        description: "Read the full content of a note by its path",
+        inputSchema: {
+            path: z
+                .string()
+                .describe("Relative path to the note within the vault"),
+        },
+    }, async ({ path: notePath }) => {
+        try {
+            const content = await readNote(vaultPath, notePath);
+            const { data: frontmatterData } = parseFrontmatter(content);
+            const header = [];
+            if (Object.keys(frontmatterData).length > 0) {
+                header.push("--- Frontmatter ---");
+                for (const [key, value] of Object.entries(frontmatterData)) {
+                    header.push(`${key}: ${JSON.stringify(value)}`);
+                }
+                header.push("--- End Frontmatter ---");
+                header.push("");
+            }
+            const tags = extractTags(content);
+            if (tags.length > 0) {
+                header.push(`Tags: ${tags.join(", ")}`);
+                header.push("");
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: header.length > 0
+                            ? header.join("\n") + content
+                            : content,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            console.error("get_note error:", err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error reading note: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.registerTool("list_notes", {
+        description: "List all notes in the vault or a specific folder",
+        inputSchema: {
+            folder: z
+                .string()
+                .optional()
+                .describe("Folder to list notes from (omit for entire vault)"),
+            limit: z
+                .number()
+                .optional()
+                .default(50)
+                .describe("Maximum number of notes to return"),
+        },
+    }, async ({ folder, limit }) => {
+        try {
+            const notes = await listNotes(vaultPath, folder);
+            const limited = notes.slice(0, limit);
+            const totalCount = notes.length;
+            const lines = [
+                `Found ${totalCount} note(s)${folder ? ` in "${folder}"` : ""}${totalCount > limit ? ` (showing first ${limit})` : ""}:`,
+                "",
+                ...limited,
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            console.error("list_notes error:", err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing notes: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.registerTool("get_daily_note", {
+        description: "Get today's daily note or a specific date's daily note",
+        inputSchema: {
+            date: z
+                .string()
+                .optional()
+                .describe("Date in YYYY-MM-DD format (defaults to today)"),
+        },
+    }, async ({ date }) => {
+        try {
+            const config = getDailyNoteConfig(vaultPath);
+            const targetDate = date ?? new Date().toISOString().slice(0, 10);
+            // Build the filename from the configured format
+            // Replace common date tokens with actual date parts
+            const [year, month, day] = targetDate.split("-");
+            let filename = config.format
+                .replace("YYYY", year)
+                .replace("MM", month)
+                .replace("DD", day);
+            if (!filename.endsWith(".md")) {
+                filename += ".md";
+            }
+            const notePath = config.folder
+                ? `${config.folder}/${filename}`
+                : filename;
+            let content;
+            try {
+                content = await readNote(vaultPath, notePath);
+            }
+            catch {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Daily note not found for ${targetDate} (expected at "${notePath}")`,
+                        },
+                    ],
+                };
+            }
+            const { data: dailyFrontmatter } = parseFrontmatter(content);
+            const header = [
+                `Daily Note: ${targetDate}`,
+                `Path: ${notePath}`,
+                "",
+            ];
+            if (Object.keys(dailyFrontmatter).length > 0) {
+                header.push("--- Frontmatter ---");
+                for (const [key, value] of Object.entries(dailyFrontmatter)) {
+                    header.push(`${key}: ${JSON.stringify(value)}`);
+                }
+                header.push("--- End Frontmatter ---");
+                header.push("");
+            }
+            return {
+                content: [
+                    { type: "text", text: header.join("\n") + content },
+                ],
+            };
+        }
+        catch (err) {
+            console.error("get_daily_note error:", err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error reading daily note: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.registerTool("search_by_frontmatter", {
+        description: "Search notes by frontmatter property values",
+        inputSchema: {
+            property: z
+                .string()
+                .describe("Frontmatter property key to search for"),
+            value: z.string().describe("Value to match against the property"),
+            folder: z
+                .string()
+                .optional()
+                .describe("Limit search to a specific folder"),
+        },
+    }, async ({ property, value, folder }) => {
+        try {
+            const notes = await listNotes(vaultPath, folder);
+            const matches = [];
+            for (const notePath of notes) {
+                let content;
+                try {
+                    content = await readNote(vaultPath, notePath);
+                }
+                catch {
+                    console.error(`Failed to read note during frontmatter search: ${notePath}`);
+                    continue;
+                }
+                const { data: frontmatterData } = parseFrontmatter(content);
+                const propValue = frontmatterData[property];
+                if (propValue === undefined)
+                    continue;
+                const stringified = Array.isArray(propValue)
+                    ? propValue.map(String)
+                    : [String(propValue)];
+                const isMatch = stringified.some((v) => v.toLowerCase() === value.toLowerCase());
+                if (isMatch) {
+                    matches.push({ path: notePath, frontmatter: frontmatterData });
+                }
+            }
+            if (matches.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No notes found with frontmatter "${property}" matching "${value}"`,
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `Found ${matches.length} note(s) where "${property}" matches "${value}":`,
+                "",
+            ];
+            for (const match of matches) {
+                lines.push(`## ${match.path}`);
+                for (const [key, val] of Object.entries(match.frontmatter)) {
+                    lines.push(`  ${key}: ${JSON.stringify(val)}`);
+                }
+                lines.push("");
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            console.error("search_by_frontmatter error:", err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error searching by frontmatter: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=read.js.map

package/build/tools/read.js.map

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

package/build/tools/tags.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTagTools(server: McpServer, vaultPath: string): void;
+//# sourceMappingURL=tags.d.ts.map

package/build/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;AAMpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CA8J3E"}

package/build/tools/tags.js

@@ -0,0 +1,146 @@
+import { z } from "zod";
+import { listNotes, readNote } from "../lib/vault.js";
+import { extractTags } from "../lib/markdown.js";
+export function registerTagTools(server, vaultPath) {
+    server.registerTool("get_tags", {
+        description: "List all tags used in the vault with their usage counts",
+        inputSchema: {
+            sortBy: z
+                .enum(["count", "name"])
+                .optional()
+                .default("count")
+                .describe("Sort tags by usage count (descending) or name (alphabetical)"),
+        },
+    }, async ({ sortBy }) => {
+        try {
+            const notes = await listNotes(vaultPath);
+            const tagMap = new Map();
+            for (const notePath of notes) {
+                let content;
+                try {
+                    content = await readNote(vaultPath, notePath);
+                }
+                catch (err) {
+                    console.error(`Failed to read note for tag extraction: ${notePath}`, err);
+                    continue;
+                }
+                const tags = extractTags(content);
+                for (const tag of tags) {
+                    const normalizedTag = tag.toLowerCase();
+                    const existing = tagMap.get(normalizedTag);
+                    if (existing) {
+                        existing.count++;
+                        if (!existing.files.includes(notePath)) {
+                            existing.files.push(notePath);
+                        }
+                    }
+                    else {
+                        tagMap.set(normalizedTag, {
+                            tag: normalizedTag,
+                            count: 1,
+                            files: [notePath],
+                        });
+                    }
+                }
+            }
+            const tagInfos = Array.from(tagMap.values());
+            if (sortBy === "name") {
+                tagInfos.sort((a, b) => a.tag.localeCompare(b.tag));
+            }
+            else {
+                tagInfos.sort((a, b) => b.count - a.count || a.tag.localeCompare(b.tag));
+            }
+            const lines = [];
+            lines.push(`Total unique tags: ${tagInfos.length}`);
+            lines.push("");
+            for (const info of tagInfos) {
+                lines.push(`#${info.tag} (${info.count} ${info.count === 1 ? "note" : "notes"})`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            console.error("Error in get_tags:", err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing tags: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+    server.registerTool("search_by_tag", {
+        description: "Find all notes that contain a specific tag",
+        inputSchema: {
+            tag: z.string().describe("Tag to search for (with or without # prefix)"),
+            includeContent: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("If true, include first 200 characters of note content as a preview"),
+        },
+    }, async ({ tag, includeContent }) => {
+        try {
+            const searchTag = tag.replace(/^#/, "").toLowerCase();
+            const notes = await listNotes(vaultPath);
+            const matchingNotes = [];
+            for (const notePath of notes) {
+                let content;
+                try {
+                    content = await readNote(vaultPath, notePath);
+                }
+                catch (err) {
+                    console.error(`Failed to read note for tag search: ${notePath}`, err);
+                    continue;
+                }
+                const tags = extractTags(content);
+                const hasMatch = tags.some((t) => {
+                    const normalized = t.toLowerCase();
+                    return normalized === searchTag || normalized.startsWith(`${searchTag}/`);
+                });
+                if (hasMatch) {
+                    const entry = { path: notePath };
+                    if (includeContent) {
+                        entry.preview = content.slice(0, 200).trim();
+                    }
+                    matchingNotes.push(entry);
+                }
+            }
+            if (matchingNotes.length === 0) {
+                return {
+                    content: [
+                        { type: "text", text: `No notes found with tag #${searchTag}` },
+                    ],
+                };
+            }
+            const lines = [];
+            lines.push(`Found ${matchingNotes.length} ${matchingNotes.length === 1 ? "note" : "notes"} with tag #${searchTag}`);
+            lines.push("");
+            for (const note of matchingNotes) {
+                lines.push(`- ${note.path}`);
+                if (note.preview) {
+                    lines.push(`  ${note.preview}`);
+                    lines.push("");
+                }
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            console.error("Error in search_by_tag:", err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error searching by tag: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=tags.js.map

package/build/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/build/tools/write.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerWriteTools(server: McpServer, vaultPath: string): void;
+//# sourceMappingURL=write.d.ts.map

package/build/tools/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/tools/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyDpE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAyO7E"}