@l22-io/orchard-mcp 0.3.1

package/build/setup.js

@@ -0,0 +1,362 @@
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createInterface } from "node:readline";
+import { mkdirSync, copyFileSync, existsSync, readFileSync, unlinkSync, } from "node:fs";
+import { randomUUID } from "node:crypto";
+import { tmpdir } from "node:os";
+const execFileAsync = promisify(execFile);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = resolve(__dirname, "..");
+const swiftDir = resolve(projectRoot, "swift");
+const bridgeBin = resolve(swiftDir, ".build", "release", "apple-bridge");
+const appBundle = resolve(swiftDir, ".build", "AppleBridge.app");
+const infoPlist = resolve(swiftDir, "Sources", "AppleBridge", "Info.plist");
+function log(msg) {
+    process.stdout.write(`      ${msg}\n`);
+}
+function step(n, total, title) {
+    process.stdout.write(`\n[${n}/${total}] ${title}\n`);
+}
+async function ask(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((res) => {
+        rl.question(`      ${question} `, (answer) => {
+            rl.close();
+            res(answer.trim());
+        });
+    });
+}
+async function run(cmd, args, opts) {
+    return execFileAsync(cmd, args, {
+        timeout: opts?.timeout ?? 120_000,
+        maxBuffer: 10 * 1024 * 1024,
+        cwd: opts?.cwd,
+    });
+}
+export async function runSetup(nonInteractive) {
+    const total = 6;
+    process.stdout.write("\norchard-mcp setup\n================\n");
+    const ok1 = await checkPrereqs(total);
+    if (!ok1)
+        process.exit(1);
+    const ok2 = await buildSwift(total);
+    if (!ok2)
+        process.exit(1);
+    await buildAppBundle(total);
+    await requestPermissions(total, nonInteractive);
+    await printClientConfig(total);
+    await validate(total);
+}
+// Step 1: Prerequisites
+async function checkPrereqs(total) {
+    step(1, total, "Checking prerequisites...");
+    let ok = true;
+    try {
+        const { stdout } = await run("sw_vers", ["-productVersion"]);
+        const ver = stdout.trim();
+        const major = parseInt(ver.split(".")[0], 10);
+        if (major >= 14) {
+            log(`macOS ${ver} -- ok`);
+        }
+        else {
+            log(`macOS ${ver} -- requires 14+ (Sonoma or later)`);
+            ok = false;
+        }
+    }
+    catch {
+        log("Could not detect macOS version");
+        ok = false;
+    }
+    try {
+        const { stdout } = await run("swift", ["--version"]);
+        const match = stdout.match(/Swift version ([\d.]+)/);
+        const ver = match ? match[1] : "unknown";
+        log(`Swift ${ver} -- ok`);
+    }
+    catch {
+        log("Swift not found -- install Xcode Command Line Tools: xcode-select --install");
+        ok = false;
+    }
+    const nodeVer = process.version;
+    const nodeMajor = parseInt(nodeVer.slice(1).split(".")[0], 10);
+    if (nodeMajor >= 18) {
+        log(`Node.js ${nodeVer} -- ok`);
+    }
+    else {
+        log(`Node.js ${nodeVer} -- requires 18+`);
+        ok = false;
+    }
+    return ok;
+}
+// Step 2: Build Swift
+async function buildSwift(total) {
+    step(2, total, "Building Swift binary...");
+    if (existsSync(bridgeBin)) {
+        log("Binary already exists -- skipping build.");
+        return true;
+    }
+    try {
+        await run("swift", [
+            "build",
+            "-c",
+            "release",
+            "-Xlinker",
+            "-sectcreate",
+            "-Xlinker",
+            "__TEXT",
+            "-Xlinker",
+            "__info_plist",
+            "-Xlinker",
+            "Sources/AppleBridge/Info.plist",
+        ], { cwd: swiftDir, timeout: 300_000 });
+        log("swift build -c release -- ok");
+        return true;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`Swift build failed: ${msg}`);
+        return false;
+    }
+}
+// Step 3: Build .app bundle
+async function buildAppBundle(total) {
+    step(3, total, "Building AppleBridge.app bundle...");
+    const macosDir = resolve(appBundle, "Contents", "MacOS");
+    const binaryInApp = resolve(macosDir, "apple-bridge");
+    if (existsSync(binaryInApp)) {
+        log("App bundle already exists -- skipping build.");
+        return;
+    }
+    mkdirSync(macosDir, { recursive: true });
+    copyFileSync(bridgeBin, resolve(macosDir, "apple-bridge"));
+    copyFileSync(infoPlist, resolve(appBundle, "Contents", "Info.plist"));
+    try {
+        await run("codesign", ["--force", "--sign", "-", appBundle]);
+        log("Created and signed -- ok");
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`codesign failed: ${msg}`);
+    }
+}
+// Step 4: TCC permissions
+async function requestPermissions(total, nonInteractive) {
+    step(4, total, "Requesting permissions...");
+    // Helper: parse doctor output
+    async function getDoctor() {
+        try {
+            const { stdout } = await run(bridgeBin, ["doctor"]);
+            const parsed = JSON.parse(stdout);
+            return parsed.data ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    // Helper: run command via .app bundle, return parsed JSON or null
+    async function runViaApp(args) {
+        const outputFile = resolve(tmpdir(), `apple-bridge-${randomUUID()}.json`);
+        try {
+            const child = spawn("open", [
+                "-W",
+                "-n",
+                "-a",
+                appBundle,
+                "--args",
+                ...args,
+                "--output",
+                outputFile,
+            ]);
+            await new Promise((res) => {
+                child.on("close", () => res());
+                child.on("error", () => res());
+                setTimeout(() => {
+                    child.kill();
+                    res();
+                }, 15_000);
+            });
+            if (existsSync(outputFile)) {
+                const data = JSON.parse(readFileSync(outputFile, "utf-8"));
+                try {
+                    unlinkSync(outputFile);
+                }
+                catch { }
+                return data;
+            }
+            return null;
+        }
+        catch {
+            try {
+                unlinkSync(outputFile);
+            }
+            catch { }
+            return null;
+        }
+    }
+    const doctor = await getDoctor();
+    // Calendar
+    if (doctor?.calendar?.granted) {
+        log("Calendar: fullAccess -- ok");
+    }
+    else if (nonInteractive) {
+        log("Calendar: not granted (run interactively to trigger prompt)");
+    }
+    else {
+        log("Calendar: requesting access...");
+        try {
+            await run(bridgeBin, ["calendars"]);
+        }
+        catch { }
+        const d2 = await getDoctor();
+        if (d2?.calendar?.granted) {
+            log("Calendar: fullAccess -- ok");
+        }
+        else {
+            log("Calendar: not granted -- open System Settings > Privacy & Security > Calendars");
+        }
+    }
+    // Reminders (needs .app bundle for TCC on Sequoia)
+    if (doctor?.reminders?.granted) {
+        log("Reminders: fullAccess -- ok");
+    }
+    else if (nonInteractive) {
+        log("Reminders: not granted (run interactively to trigger prompt)");
+    }
+    else {
+        log("Reminders: requesting access via AppleBridge.app...");
+        log("Grant access in the dialog that appears.");
+        await runViaApp(["reminder-lists"]);
+        await ask("Press Enter after granting access...");
+        // Verify via .app bundle (direct binary won't have TCC on Sequoia)
+        const result = await runViaApp(["reminder-lists"]);
+        if (result?.status === "ok") {
+            log("Reminders: fullAccess -- ok");
+        }
+        else {
+            log("Reminders: not granted -- open System Settings > Privacy & Security > Reminders");
+        }
+    }
+    // Mail
+    if (doctor?.mail?.accessible) {
+        const count = doctor.mail.accountCount ?? 0;
+        log(`Mail: accessible (${count} accounts) -- ok`);
+    }
+    else if (nonInteractive) {
+        log("Mail: not accessible (run interactively to trigger prompt)");
+    }
+    else {
+        log("Mail: requesting access (Mail.app must be running)...");
+        try {
+            await run(bridgeBin, ["mail-accounts"]);
+        }
+        catch { }
+        const d2 = await getDoctor();
+        if (d2?.mail?.accessible) {
+            log(`Mail: accessible (${d2.mail.accountCount} accounts) -- ok`);
+        }
+        else {
+            log("Mail: not accessible -- ensure Mail.app is running and grant Automation permission");
+        }
+    }
+}
+// Step 5: MCP client config
+async function printClientConfig(total) {
+    step(5, total, "MCP client configuration");
+    const serverPath = resolve(projectRoot, "build", "index.js");
+    const warpExists = existsSync("/Applications/Warp.app");
+    if (warpExists) {
+        log("Warp detected. Add this MCP server in Warp settings:");
+        log(`  Command: node`);
+        log(`  Args: ${serverPath}`);
+    }
+    let claudeExists = false;
+    try {
+        await run("which", ["claude"]);
+        claudeExists = true;
+    }
+    catch { }
+    if (claudeExists) {
+        log("Claude Code detected. Run:");
+        log(`  claude mcp add --scope user orchard -- node ${serverPath}`);
+    }
+    if (!warpExists && !claudeExists) {
+        log("No supported MCP clients detected (Warp, Claude Code).");
+        log("Generic MCP config:");
+        log(`  Command: node`);
+        log(`  Args: ${serverPath}`);
+    }
+}
+// Step 6: Validation
+async function validate(total) {
+    step(6, total, "Validation");
+    try {
+        const { stdout } = await run(bridgeBin, ["doctor"]);
+        const doctor = JSON.parse(stdout);
+        const d = doctor.data;
+        if (d?.calendarSummary) {
+            log(`Calendar: ${d.calendarSummary.count} calendars across ${d.calendarSummary.accounts?.length ?? 0} accounts`);
+        }
+        else {
+            log("Calendar: no access");
+        }
+        // Reminders: try direct first, fall back to .app bundle
+        if (d?.remindersSummary && d.remindersSummary.count > 0) {
+            log(`Reminders: ${d.remindersSummary.count} lists`);
+        }
+        else {
+            const outputFile = resolve(tmpdir(), `apple-bridge-validate-${randomUUID()}.json`);
+            try {
+                const child = spawn("open", [
+                    "-W",
+                    "-n",
+                    "-a",
+                    appBundle,
+                    "--args",
+                    "reminder-lists",
+                    "--output",
+                    outputFile,
+                ]);
+                await new Promise((res) => {
+                    child.on("close", () => res());
+                    child.on("error", () => res());
+                    setTimeout(() => {
+                        child.kill();
+                        res();
+                    }, 10_000);
+                });
+                if (existsSync(outputFile)) {
+                    const data = JSON.parse(readFileSync(outputFile, "utf-8"));
+                    unlinkSync(outputFile);
+                    if (data.status === "ok" && Array.isArray(data.data)) {
+                        const items = data.data.reduce((sum, l) => sum + (l.itemCount ?? 0), 0);
+                        log(`Reminders: ${data.data.length} lists (${items.toLocaleString()} items)`);
+                    }
+                    else {
+                        log("Reminders: no access");
+                    }
+                }
+                else {
+                    log("Reminders: no access");
+                }
+            }
+            catch {
+                log("Reminders: no access");
+            }
+        }
+        if (d?.mail?.accessible) {
+            log(`Mail: ${d.mail.accountCount} accounts`);
+        }
+        else {
+            log("Mail: no access");
+        }
+        log("");
+        log("Ready to use.");
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log(`Validation failed: ${msg}`);
+    }
+}
+//# sourceMappingURL=setup.js.map

package/build/setup.js.map

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

package/build/tools/calendar.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCalendarTools(server: McpServer): void;

package/build/tools/calendar.js

@@ -0,0 +1,61 @@
+import { z } from "zod";
+import { bridgeData } from "../bridge.js";
+export function registerCalendarTools(server) {
+    server.tool("calendar.list_calendars", "List all Apple Calendar calendars with account name, type, color, and read-only status.", {}, async () => {
+        const data = await bridgeData(["calendars"]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("calendar.list_events", "List calendar events in a date range. Recurring events are properly expanded. Optionally filter by calendar ID.", {
+        start: z
+            .string()
+            .describe("Start date in ISO 8601 format (e.g. 2026-02-17 or 2026-02-17T00:00:00Z)"),
+        end: z
+            .string()
+            .describe("End date in ISO 8601 format"),
+        calendarId: z
+            .string()
+            .optional()
+            .describe("Optional calendar ID to filter by (from calendar.list_calendars)"),
+    }, async ({ start, end, calendarId }) => {
+        const args = ["events", "--start", start, "--end", end];
+        if (calendarId) {
+            args.push("--calendar", calendarId);
+        }
+        const data = await bridgeData(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("calendar.today", "Get all calendar events for today across all calendars.", {}, async () => {
+        // Reason: Build today's date range in local timezone for the bridge.
+        const now = new Date();
+        const startOfDay = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+        const endOfDay = new Date(now.getFullYear(), now.getMonth(), now.getDate() + 1);
+        const start = startOfDay.toISOString();
+        const end = endOfDay.toISOString();
+        const data = await bridgeData(["events", "--start", start, "--end", end]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("calendar.search", "Search calendar events by title, notes, or location within a date range.", {
+        query: z.string().describe("Search term to match against event title, notes, or location"),
+        start: z.string().describe("Start date in ISO 8601 format"),
+        end: z.string().describe("End date in ISO 8601 format"),
+    }, async ({ query, start, end }) => {
+        const data = await bridgeData([
+            "search",
+            query,
+            "--start",
+            start,
+            "--end",
+            end,
+        ]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=calendar.js.map

package/build/tools/calendar.js.map

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

package/build/tools/files.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerFileTools(server: McpServer): void;

package/build/tools/files.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { bridgeData } from "../bridge.js";
+export function registerFileTools(server) {
+    server.tool("files.list", "List directory contents with metadata (name, size, dates, type). Paths relative to home directory.", {
+        path: z
+            .string()
+            .optional()
+            .describe("Directory path relative to ~ (default: home directory)"),
+        recursive: z
+            .boolean()
+            .optional()
+            .describe("List recursively (default: false)"),
+        depth: z
+            .number()
+            .optional()
+            .describe("Max recursion depth when recursive (default: 3)"),
+    }, async ({ path, recursive, depth }) => {
+        const args = ["file-list"];
+        if (path)
+            args.push("--path", path);
+        if (recursive)
+            args.push("--recursive");
+        if (depth !== undefined)
+            args.push("--depth", String(depth));
+        const data = await bridgeData(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("files.info", "Get detailed metadata for a file or folder, including Spotlight attributes (content type, dimensions, authors, page count).", {
+        path: z
+            .string()
+            .describe("File path relative to ~ or absolute (must be under home directory)"),
+    }, async ({ path }) => {
+        const data = await bridgeData(["file-info", "--path", path]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("files.search", "Search files using macOS Spotlight. Searches file names and content across indexed volumes. Scoped to home directory.", {
+        query: z
+            .string()
+            .describe("Search query (Spotlight syntax, e.g. 'budget 2026' or 'kMDItemAuthor == \"John\"')"),
+        kind: z
+            .enum([
+            "folder",
+            "image",
+            "pdf",
+            "document",
+            "audio",
+            "video",
+            "presentation",
+            "spreadsheet",
+        ])
+            .optional()
+            .describe("Filter by file kind"),
+        scope: z
+            .string()
+            .optional()
+            .describe("Subdirectory to search within (default: entire home directory)"),
+    }, async ({ query, kind, scope }) => {
+        const args = ["file-search", "--query", query];
+        if (kind)
+            args.push("--kind", kind);
+        if (scope)
+            args.push("--scope", scope);
+        const data = await bridgeData(args);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("files.read", "Read and extract text from a file. Handles plain text, PDF (via PDFKit), images (via OCR), and documents (.docx, .rtf, .pages via textutil). Text capped at 1MB.", {
+        path: z
+            .string()
+            .describe("File path relative to ~ or absolute (must be under home directory)"),
+    }, async ({ path }) => {
+        const data = await bridgeData(["file-read", "--path", path]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("files.move", "Move or rename files and folders. Supports batch operations for mass renaming. All paths must be under home directory.", {
+        operations: z
+            .array(z.object({
+            source: z.string().describe("Source path"),
+            destination: z.string().describe("Destination path"),
+        }))
+            .describe("Array of move operations ({source, destination} pairs)"),
+    }, async ({ operations }) => {
+        const data = await bridgeData([
+            "file-move",
+            "--items",
+            JSON.stringify(operations),
+        ]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("files.copy", "Copy a file or folder to a new location. Both paths must be under home directory.", {
+        source: z.string().describe("Source file or folder path"),
+        destination: z.string().describe("Destination path"),
+    }, async ({ source, destination }) => {
+        const data = await bridgeData([
+            "file-copy",
+            "--source",
+            source,
+            "--dest",
+            destination,
+        ]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("files.create_folder", "Create a new directory with intermediate directories. Path must be under home directory.", {
+        path: z.string().describe("Directory path to create"),
+    }, async ({ path }) => {
+        const data = await bridgeData(["file-create-folder", "--path", path]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+    server.tool("files.trash", "Move a file or folder to the Trash (reversible delete). Path must be under home directory.", {
+        path: z.string().describe("File or folder path to move to Trash"),
+    }, async ({ path }) => {
+        const data = await bridgeData(["file-trash", "--path", path]);
+        return {
+            content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=files.js.map

package/build/tools/files.js.map

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

package/build/tools/mail.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMailTools(server: McpServer): void;