@tekmidian/devon 3.0.0

package/dist/tools/web/create-from-url.js

@@ -0,0 +1,140 @@
+/**
+ * create-from-url.ts — Create a DEVONthink record from a web URL.
+ *
+ * Supports four capture formats: formatted_note, markdown, pdf, and web_document.
+ * Optionally places the new record in a specified group and supports readability
+ * mode, custom user-agent, referrer, and PDF pagination options.
+ */
+import { z } from "zod";
+import { defineTool } from "../../jxa/types.js";
+import { jxaLiteral } from "../../jxa/escape.js";
+import { JXA_APP, JXA_RECORD_PROPS } from "../../jxa/helpers.js";
+const FORMAT_VALUES = [
+    "formatted_note",
+    "markdown",
+    "pdf",
+    "web_document",
+];
+export const createFromUrlTool = defineTool({
+    name: "create_from_url",
+    description: "Create a record in DEVONthink from a web URL.",
+    schema: z.object({
+        url: z.string().url().describe("The web URL to capture"),
+        format: z
+            .enum(FORMAT_VALUES)
+            .describe("Capture format: formatted_note, markdown, pdf, or web_document"),
+        name: z
+            .string()
+            .optional()
+            .describe("Name for the new record (defaults to page title)"),
+        parentGroupUuid: z
+            .string()
+            .optional()
+            .describe("UUID of the parent group to place the new record in"),
+        readability: z
+            .boolean()
+            .optional()
+            .describe("Use readability mode to strip navigation and ads (where supported)"),
+        userAgent: z
+            .string()
+            .optional()
+            .describe("Custom HTTP User-Agent header for the request"),
+        referrer: z
+            .string()
+            .optional()
+            .describe("HTTP Referer header for the request"),
+        pdfOptions: z
+            .object({
+            pagination: z
+                .boolean()
+                .optional()
+                .describe("Enable pagination in the PDF"),
+            width: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("Page width in pixels for the PDF"),
+        })
+            .optional()
+            .describe("PDF-specific options (only applies when format is 'pdf')"),
+        databaseName: z
+            .string()
+            .optional()
+            .describe("Target database name; uses current database if omitted"),
+    }),
+    run: async (args, executor) => {
+        const { url, format, name, parentGroupUuid, readability, userAgent, referrer, pdfOptions, databaseName, } = args;
+        const script = `
+      ${JXA_APP}
+      var url = ${jxaLiteral(url)};
+      var format = ${jxaLiteral(format)};
+      var name = ${jxaLiteral(name ?? null)};
+      var parentGroupUuid = ${jxaLiteral(parentGroupUuid ?? null)};
+      var readability = ${jxaLiteral(readability ?? false)};
+      var userAgent = ${jxaLiteral(userAgent ?? null)};
+      var referrer = ${jxaLiteral(referrer ?? null)};
+      var pdfPagination = ${jxaLiteral(pdfOptions?.pagination ?? null)};
+      var pdfWidth = ${jxaLiteral(pdfOptions?.width ?? null)};
+      var dbName = ${jxaLiteral(databaseName ?? null)};
+
+      // Resolve target database
+      var targetDb;
+      if (dbName) {
+        var dbs = app.databases();
+        targetDb = null;
+        for (var i = 0; i < dbs.length; i++) {
+          if (dbs[i].name() === dbName) { targetDb = dbs[i]; break; }
+        }
+        if (!targetDb) throw new Error("Database not found: " + dbName);
+      } else {
+        targetDb = app.currentDatabase();
+      }
+
+      // Resolve parent group
+      var parentGroup = null;
+      if (parentGroupUuid) {
+        parentGroup = app.getRecordWithUuid(parentGroupUuid);
+        if (!parentGroup || !parentGroup.uuid()) {
+          throw new Error("Parent group not found for UUID: " + parentGroupUuid);
+        }
+      } else {
+        parentGroup = targetDb.root();
+      }
+
+      // Build common options
+      var opts = {in: parentGroup};
+      if (name) opts["name"] = name;
+      if (readability) opts["readability"] = true;
+      if (userAgent) opts["agent"] = userAgent;
+      if (referrer) opts["referrer"] = referrer;
+
+      var record;
+
+      if (format === "formatted_note") {
+        record = app.createFormattedNoteFrom(url, opts);
+
+      } else if (format === "markdown") {
+        record = app.createMarkdownFrom(url, opts);
+
+      } else if (format === "pdf") {
+        if (pdfPagination !== null) opts["paginate"] = pdfPagination;
+        if (pdfWidth !== null) opts["width"] = pdfWidth;
+        record = app.createPDFDocumentFrom(url, opts);
+
+      } else if (format === "web_document") {
+        record = app.createWebDocumentFrom(url, opts);
+
+      } else {
+        throw new Error("Unknown format: " + format);
+      }
+
+      if (!record || !record.uuid()) throw new Error("Failed to create record from URL: " + url);
+
+      JSON.stringify(${JXA_RECORD_PROPS});
+    `;
+        const result = executor.run(script);
+        return JSON.parse(result.stdout);
+    },
+});
+//# sourceMappingURL=create-from-url.js.map

package/dist/tools/web/create-from-url.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@tekmidian/devon",
+  "version": "3.0.0",
+  "description": "DEVONthink MCP server for Claude Code. Zero-config setup with automatic Claude configuration.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "devon": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "devonthink",
+    "claude",
+    "claude-code",
+    "mcp-server",
+    "macos",
+    "document-management",
+    "applescript"
+  ],
+  "license": "MIT",
+  "author": "Matthias Nott",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mnott/Devon.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.0.1",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.7"
+  }
+}