@tekmidian/devonthink-mcp 1.0.0 → 2.0.1

package/dist/tools/listSmartGroups.js.map

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

package/dist/tools/listSmartRules.d.ts

@@ -0,0 +1,36 @@
+/**
+ * listSmartRules.ts — Parse DEVONthink SmartRules.plist to enumerate all smart rules.
+ *
+ * Smart rules are NOT accessible via the standard MCP or AppleScript scripting dictionary.
+ * This tool reads the plist file directly using `plutil -convert xml1` to return
+ * all smart rules with their names, UUIDs, enabled state, and other metadata.
+ *
+ * Note: `plutil -convert json` fails because the `data` field contains binary NSKeyedArchiver
+ * content that cannot be represented in JSON. XML format represents it as base64, which we skip.
+ */
+interface SmartRuleEntry {
+    name: string;
+    uuid: string;
+    enabled: boolean | null;
+    indexOffset: number | null;
+    lastExecution: number | null;
+    syncDate: string | null;
+    useUuidKey: boolean | null;
+}
+interface SmartRulesResult {
+    success: boolean;
+    smartRules?: SmartRuleEntry[];
+    totalCount?: number;
+    error?: string;
+}
+export declare const listSmartRulesTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    run: () => Promise<SmartRulesResult>;
+};
+export {};

package/dist/tools/listSmartRules.js

@@ -0,0 +1,115 @@
+/**
+ * listSmartRules.ts — Parse DEVONthink SmartRules.plist to enumerate all smart rules.
+ *
+ * Smart rules are NOT accessible via the standard MCP or AppleScript scripting dictionary.
+ * This tool reads the plist file directly using `plutil -convert xml1` to return
+ * all smart rules with their names, UUIDs, enabled state, and other metadata.
+ *
+ * Note: `plutil -convert json` fails because the `data` field contains binary NSKeyedArchiver
+ * content that cannot be represented in JSON. XML format represents it as base64, which we skip.
+ */
+import { execSync } from "node:child_process";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { extractStringAfterKey, extractBoolAfterKey, extractIntegerAfterKey, extractRealAfterKey, extractDateAfterKey, extractSubDictAfterKey, extractTopLevelDicts, } from "./listSmartGroups.js";
+const PLIST_PATH = join(homedir(), "Library", "Application Support", "DEVONthink", "SmartRules.plist");
+/**
+ * Parse a plist XML string (output of `plutil -convert xml1`) and return
+ * an array of smart rule entries.
+ *
+ * The top-level structure is:
+ *   <plist><array>
+ *     <dict>
+ *       <key>Enabled</key><true/> or <false/>
+ *       <key>IndexOffset</key><integer>...</integer>
+ *       <key>LastExecution</key><real>...</real>
+ *       <key>UseUUIDKey</key><true/> or <false/>
+ *       <key>data</key><data>...</data>          <!-- binary, skip -->
+ *       <key>name</key><string>...</string>
+ *       <key>settings</key><dict>...</dict>      <!-- skip -->
+ *       <key>sync</key>
+ *       <dict>
+ *         <key>UUID</key><string>...</string>
+ *         <key>date</key><date>...</date>
+ *       </dict>
+ *     </dict>
+ *     ...
+ *   </array></plist>
+ */
+function parsePlistXmlToSmartRules(xml) {
+    const topLevelDicts = extractTopLevelDicts(xml);
+    const results = [];
+    for (const dictContent of topLevelDicts) {
+        const name = extractStringAfterKey(dictContent, "name");
+        const enabled = extractBoolAfterKey(dictContent, "Enabled");
+        const indexOffset = extractIntegerAfterKey(dictContent, "IndexOffset");
+        const lastExecution = extractRealAfterKey(dictContent, "LastExecution");
+        const useUuidKey = extractBoolAfterKey(dictContent, "UseUUIDKey");
+        // The sync sub-dict: find the <dict> that follows the <key>sync</key>
+        const syncContent = extractSubDictAfterKey(dictContent, "sync");
+        const uuid = syncContent ? extractStringAfterKey(syncContent, "UUID") : null;
+        const syncDate = syncContent ? extractDateAfterKey(syncContent, "date") : null;
+        // Skip entries with no name or UUID (shouldn't happen, but be defensive)
+        if (!name && !uuid)
+            continue;
+        results.push({
+            name: name ?? "(unnamed)",
+            uuid: uuid ?? "",
+            enabled: enabled,
+            indexOffset: indexOffset,
+            lastExecution: lastExecution,
+            syncDate: syncDate ?? null,
+            useUuidKey: useUuidKey,
+        });
+    }
+    return results;
+}
+const listSmartRules = async () => {
+    if (!existsSync(PLIST_PATH)) {
+        return {
+            success: false,
+            error: `SmartRules.plist not found at: ${PLIST_PATH}. Ensure DEVONthink has been run at least once and smart rules have been created.`,
+        };
+    }
+    let xml;
+    try {
+        xml = execSync(`plutil -convert xml1 -o - "${PLIST_PATH}"`, {
+            encoding: "utf-8",
+            timeout: 10000,
+        });
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Failed to parse SmartRules.plist: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    let smartRules;
+    try {
+        smartRules = parsePlistXmlToSmartRules(xml);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Failed to parse XML output from plutil: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // Sort alphabetically by name
+    smartRules.sort((a, b) => a.name.localeCompare(b.name));
+    return { success: true, smartRules, totalCount: smartRules.length };
+};
+export const listSmartRulesTool = {
+    name: "list_smart_rules",
+    description: "List all DEVONthink smart rules by parsing SmartRules.plist. " +
+        "Returns name, UUID (from sync.UUID), enabled state, indexOffset, lastExecution timestamp, " +
+        "and sync date for each rule. " +
+        "Smart rules are NOT accessible via the standard AppleScript API — this is the only way to enumerate them.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+    },
+    run: listSmartRules,
+};
+//# sourceMappingURL=listSmartRules.js.map

package/dist/tools/listSmartRules.js.map

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

package/dist/tools/parseEmlHeaders.d.ts

@@ -0,0 +1,40 @@
+/**
+ * parseEmlHeaders.ts — Extract MIME headers from .eml files.
+ *
+ * Reads an RFC 2822 email file and returns the key headers needed for
+ * thread correlation: Message-ID, In-Reply-To, References, Subject, From, To, Date.
+ *
+ * Handles:
+ *   - CRLF and LF line endings
+ *   - Folded headers (continuation lines starting with whitespace)
+ *   - Encoded words (=?charset?encoding?text?=) in Subject/From/To — decoded to UTF-8
+ */
+interface EmlHeadersResult {
+    success: boolean;
+    filePath?: string;
+    messageId?: string | null;
+    inReplyTo?: string | null;
+    references?: string[];
+    subject?: string | null;
+    from?: string | null;
+    to?: string | null;
+    cc?: string | null;
+    date?: string | null;
+    error?: string;
+}
+export declare const parseEmlHeadersTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            filePath: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    run: (args: Record<string, unknown>) => Promise<EmlHeadersResult>;
+};
+export {};

package/dist/tools/parseEmlHeaders.js

@@ -0,0 +1,183 @@
+/**
+ * parseEmlHeaders.ts — Extract MIME headers from .eml files.
+ *
+ * Reads an RFC 2822 email file and returns the key headers needed for
+ * thread correlation: Message-ID, In-Reply-To, References, Subject, From, To, Date.
+ *
+ * Handles:
+ *   - CRLF and LF line endings
+ *   - Folded headers (continuation lines starting with whitespace)
+ *   - Encoded words (=?charset?encoding?text?=) in Subject/From/To — decoded to UTF-8
+ */
+import { existsSync } from "node:fs";
+/**
+ * Decode RFC 2047 encoded-word sequences like =?utf-8?B?...?= or =?utf-8?Q?...?=
+ */
+function decodeEncodedWords(input) {
+    // Match encoded-word: =?charset?encoding?encoded_text?=
+    return input.replace(/=\?([^?]+)\?([BbQq])\?([^?]*)\?=/g, (_match, charset, encoding, text) => {
+        try {
+            const enc = encoding.toUpperCase();
+            let bytes;
+            if (enc === "B") {
+                bytes = Buffer.from(text, "base64");
+            }
+            else {
+                // Q encoding: _ is space, = followed by hex digits
+                const decoded = text
+                    .replace(/_/g, " ")
+                    .replace(/=([0-9A-Fa-f]{2})/g, (_m, h) => String.fromCharCode(parseInt(h, 16)));
+                bytes = Buffer.from(decoded, "binary");
+            }
+            return bytes.toString(charset.toLowerCase() || "utf-8");
+        }
+        catch {
+            return _match;
+        }
+    });
+}
+/**
+ * Parse RFC 2822 headers from a raw string (the header section of an .eml).
+ * Returns a map of lower-cased header names to their unfolded values.
+ */
+function parseHeaders(headerSection) {
+    const headers = new Map();
+    // Normalise CRLF to LF
+    const normalised = headerSection.replace(/\r\n/g, "\n");
+    const lines = normalised.split("\n");
+    let currentName = null;
+    let currentValue = "";
+    const flush = () => {
+        if (currentName !== null) {
+            // Fold whitespace: collapse folded continuation into a single space
+            const unfolded = currentValue.replace(/\n[ \t]+/g, " ").trim();
+            // Multiple values for the same header (e.g. multiple Received:) — append
+            const key = currentName.toLowerCase();
+            if (headers.has(key)) {
+                headers.set(key, headers.get(key) + "\n" + unfolded);
+            }
+            else {
+                headers.set(key, unfolded);
+            }
+        }
+    };
+    for (const line of lines) {
+        if (line === "") {
+            // Blank line signals end of header section (should not appear if we split correctly)
+            break;
+        }
+        if (line[0] === " " || line[0] === "\t") {
+            // Continuation line
+            if (currentName !== null) {
+                currentValue += "\n" + line;
+            }
+        }
+        else {
+            // New header line
+            flush();
+            const colonIdx = line.indexOf(":");
+            if (colonIdx > 0) {
+                currentName = line.slice(0, colonIdx).trim();
+                currentValue = line.slice(colonIdx + 1);
+            }
+            else {
+                currentName = null;
+                currentValue = "";
+            }
+        }
+    }
+    flush();
+    return headers;
+}
+/**
+ * Parse the References header into an array of individual message IDs.
+ * References is a whitespace-separated list of <...> tokens.
+ */
+function parseReferences(raw) {
+    const matches = raw.match(/<[^>]+>/g);
+    return matches ?? [];
+}
+const parseEmlHeaders = async (args) => {
+    const { filePath } = args;
+    if (!filePath || typeof filePath !== "string") {
+        return { success: false, error: "filePath parameter is required and must be a string" };
+    }
+    if (!existsSync(filePath)) {
+        return { success: false, filePath, error: `File not found: ${filePath}` };
+    }
+    let rawContent;
+    try {
+        // Read only the first 64 KB — headers are always at the start and rarely exceed a few KB
+        const HEADER_READ_LIMIT = 65536;
+        const buf = Buffer.alloc(HEADER_READ_LIMIT);
+        const fd = await import("node:fs").then((fs) => {
+            return new Promise((resolve, reject) => {
+                const stream = fs.createReadStream(filePath, { start: 0, end: HEADER_READ_LIMIT - 1 });
+                const chunks = [];
+                stream.on("data", (chunk) => chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)));
+                stream.on("end", () => resolve(Buffer.concat(chunks)));
+                stream.on("error", reject);
+            });
+        });
+        void buf; // suppress unused variable warning
+        rawContent = fd.toString("utf-8");
+    }
+    catch (err) {
+        return {
+            success: false,
+            filePath,
+            error: `Failed to read file: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // Split on first blank line (CRLF or LF) to isolate headers from body
+    const crlf = rawContent.indexOf("\r\n\r\n");
+    const lf = rawContent.indexOf("\n\n");
+    let headerSection;
+    if (crlf !== -1 && (lf === -1 || crlf < lf)) {
+        headerSection = rawContent.slice(0, crlf);
+    }
+    else if (lf !== -1) {
+        headerSection = rawContent.slice(0, lf);
+    }
+    else {
+        // No blank line found — treat entire content as headers (unusual but handle gracefully)
+        headerSection = rawContent;
+    }
+    const headers = parseHeaders(headerSection);
+    const get = (name) => {
+        const val = headers.get(name);
+        return val !== undefined ? decodeEncodedWords(val.trim()) : null;
+    };
+    const referencesRaw = get("references");
+    return {
+        success: true,
+        filePath,
+        messageId: get("message-id"),
+        inReplyTo: get("in-reply-to"),
+        references: referencesRaw ? parseReferences(referencesRaw) : [],
+        subject: get("subject"),
+        from: get("from"),
+        to: get("to"),
+        cc: get("cc"),
+        date: get("date"),
+    };
+};
+export const parseEmlHeadersTool = {
+    name: "parse_eml_headers",
+    description: "Extract MIME headers from an .eml file for email thread correlation. " +
+        "Returns message_id, in_reply_to, references (array), subject, from, to, cc, and date. " +
+        "Handles CRLF/LF line endings, folded headers, and RFC 2047 encoded words in Subject/From/To. " +
+        'Input: { "filePath": "/path/to/email.eml" }',
+    inputSchema: {
+        type: "object",
+        properties: {
+            filePath: {
+                type: "string",
+                description: "Absolute path to the .eml file to parse",
+            },
+        },
+        required: ["filePath"],
+    },
+    run: parseEmlHeaders,
+};
+//# sourceMappingURL=parseEmlHeaders.js.map

package/dist/tools/parseEmlHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseEmlHeaders.js","sourceRoot":"","sources":["../../src/tools/parseEmlHeaders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAgB,UAAU,EAAE,MAAM,SAAS,CAAC;AAoBnD;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAAa;IACvC,wDAAwD;IACxD,OAAO,KAAK,CAAC,OAAO,CAClB,mCAAmC,EACnC,CAAC,MAAM,EAAE,OAAe,EAAE,QAAgB,EAAE,IAAY,EAAU,EAAE;QAClE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;YACnC,IAAI,KAAa,CAAC;YAClB,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;gBAChB,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,mDAAmD;gBACnD,MAAM,OAAO,GAAG,IAAI;qBACjB,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;qBAClB,OAAO,CAAC,oBAAoB,EAAE,CAAC,EAAE,EAAE,CAAS,EAAE,EAAE,CAC/C,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CACrC,CAAC;gBACJ,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,KAAK,CAAC,QAAQ,CAAE,OAAO,CAAC,WAAW,EAAqB,IAAI,OAAO,CAAC,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,YAAY,CAAC,aAAqB;IACzC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,uBAAuB;IACvB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAErC,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,IAAI,YAAY,GAAG,EAAE,CAAC;IAEtB,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,oEAAoE;YACpE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/D,yEAAyE;YACzE,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;YACtC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChB,qFAAqF;YACrF,MAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACxC,oBAAoB;YACpB,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBACzB,YAAY,IAAI,IAAI,GAAG,IAAI,CAAC;YAC9B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,KAAK,EAAE,CAAC;YACR,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC7C,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,IAAI,CAAC;gBACnB,YAAY,GAAG,EAAE,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACtC,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,eAAe,GAAG,KAAK,EAAE,IAA6B,EAA6B,EAAE;IACzF,MAAM,EAAE,QAAQ,EAAE,GAAG,IAA+B,CAAC;IAErD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;IAC1F,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAC;IAC5E,CAAC;IAED,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,yFAAyF;QACzF,MAAM,iBAAiB,GAAG,KAAK,CAAC;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;YAC7C,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,iBAAiB,GAAG,CAAC,EAAE,CAAC,CAAC;gBACvF,MAAM,MAAM,GAAa,EAAE,CAAC;gBAC5B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,CAAC,CAAC;gBACzG,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,KAAK,GAAG,CAAC,CAAC,mCAAmC;QAC7C,UAAU,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,KAAK,EAAE,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAClF,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,aAAqB,CAAC;IAE1B,IAAI,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC;QAC5C,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,wFAAwF;QACxF,aAAa,GAAG,UAAU,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC,CAAC;IAE5C,MAAM,GAAG,GAAG,CAAC,IAAY,EAAiB,EAAE;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ;QACR,SAAS,EAAE,GAAG,CAAC,YAAY,CAAC;QAC5B,SAAS,EAAE,GAAG,CAAC,aAAa,CAAC;QAC7B,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;QAC/D,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC;QACvB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;QACjB,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC;QACb,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC;QACb,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC;KAClB,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,uEAAuE;QACvE,wFAAwF;QACxF,+FAA+F;QAC/F,6CAA6C;IAC/C,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;SACF;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,GAAG,EAAE,eAAe;CACrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tekmidian/devonthink-mcp",
-  "version": "1.0.0",
+  "version": "2.0.1",
   "description": "DEVONthink MCP server for Claude Code. Zero-config setup with automatic Claude configuration.",
   "type": "module",
   "main": "dist/index.js",
@@ -37,6 +37,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "1.0.1",
     "mcp-server-devonthink": "^1.7.1"
   },
   "devDependencies": {