reflect-mcp 1.0.8 → 1.0.10

package/dist/cli.js

@@ -10,7 +10,62 @@ import { DEFAULT_DB_PATH, expandPath } from "./utils.js";
 import * as fs from "fs";
 import * as path from "path";
 import * as os from "os";
+import * as net from "net";
 import { execSync } from "child_process";
+/**
+ * Check if a port is in use
+ */
+function isPortInUse(port) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once("error", (err) => {
+            if (err.code === "EADDRINUSE") {
+                resolve(true);
+            }
+            else {
+                resolve(false);
+            }
+        });
+        server.once("listening", () => {
+            server.close();
+            resolve(false);
+        });
+        server.listen(port, "127.0.0.1");
+    });
+}
+/**
+ * Kill any process using the specified port
+ */
+function killProcessOnPort(port) {
+    try {
+        // Get PID(s) using the port
+        const pids = execSync(`lsof -ti:${port}`, { encoding: "utf-8" }).trim();
+        if (pids) {
+            console.log(`⚠️  Port ${port} in use by PID(s): ${pids.replace(/\n/g, ", ")}`);
+            execSync(`lsof -ti:${port} | xargs kill -9`, { stdio: "ignore" });
+            console.log(`✅ Killed existing process(es) on port ${port}`);
+            return true;
+        }
+    }
+    catch {
+        // No process found on port, or kill failed - that's fine
+    }
+    return false;
+}
+/**
+ * Ensure the port is free, killing any existing process if needed
+ */
+async function ensurePortFree(port) {
+    if (await isPortInUse(port)) {
+        killProcessOnPort(port);
+        // Wait a moment for the port to be released
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        // Check again
+        if (await isPortInUse(port)) {
+            throw new Error(`Port ${port} is still in use after attempting to free it`);
+        }
+    }
+}
 const REFLECT_CLIENT_ID = "55798f25d5a24efb95e4174fff3d219e";
 const LAUNCH_AGENT_LABEL = "com.reflect-mcp";
 const LAUNCH_AGENT_DIR = path.join(os.homedir(), "Library/LaunchAgents");
@@ -19,22 +74,24 @@ const LAUNCH_AGENT_PATH = path.join(LAUNCH_AGENT_DIR, `${LAUNCH_AGENT_LABEL}.pli
 const args = process.argv.slice(2);
 const command = args[0];
 // Handle commands
-if (command === "install") {
-    install(args.slice(1));
-}
-else if (command === "uninstall") {
-    uninstall();
-}
-else if (command === "status") {
-    status();
-}
-else if (command === "--help" || command === "-h") {
-    showHelp();
-}
-else {
-    // Default: run the server
-    runServer(args);
-}
+(async () => {
+    if (command === "install") {
+        await install(args.slice(1));
+    }
+    else if (command === "uninstall") {
+        uninstall();
+    }
+    else if (command === "status") {
+        status();
+    }
+    else if (command === "--help" || command === "-h") {
+        showHelp();
+    }
+    else {
+        // Default: run the server
+        await runServer(args);
+    }
+})();
 function showHelp() {
     console.log(`
 Reflect MCP Server - Connect your Reflect notes to Claude
@@ -60,7 +117,7 @@ Examples:
 `);
     process.exit(0);
 }
-function install(installArgs) {
+async function install(installArgs) {
     let dbPath = DEFAULT_DB_PATH;
     let port = 3000;
     // Parse install arguments
@@ -88,6 +145,9 @@ function install(installArgs) {
     catch {
         // Ignore errors - service might not exist yet
     }
+    // Kill any stale processes on the port
+    killProcessOnPort(port);
+    await new Promise((resolve) => setTimeout(resolve, 300));
     // Create plist content
     const plist = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
@@ -189,7 +249,7 @@ function status() {
     }
     console.log(`\n📝 Logs: tail -f /tmp/reflect-mcp.log`);
 }
-function runServer(serverArgs) {
+async function runServer(serverArgs) {
     let dbPath = DEFAULT_DB_PATH;
     let port = 3000;
     for (let i = 0; i < serverArgs.length; i++) {
@@ -200,15 +260,25 @@ function runServer(serverArgs) {
             dbPath = serverArgs[i];
         }
     }
-    startReflectMCPServer({
-        clientId: REFLECT_CLIENT_ID,
-        port,
-        dbPath,
-    }).then(() => {
+    // Ensure port is free before starting
+    try {
+        await ensurePortFree(port);
+    }
+    catch (err) {
+        console.error(`❌ ${err}`);
+        process.exit(1);
+    }
+    try {
+        await startReflectMCPServer({
+            clientId: REFLECT_CLIENT_ID,
+            port,
+            dbPath,
+        });
         console.log(`Reflect MCP Server running on http://localhost:${port}`);
         console.log(`Database: ${dbPath}`);
-    }).catch((err) => {
+    }
+    catch (err) {
         console.error("Failed to start server:", err);
         process.exit(1);
-    });
+    }
 }

package/dist/utils.d.ts

@@ -1,11 +1,20 @@
 /**
  * Utility functions for the Reflect MCP Server
  */
-export declare const DEFAULT_DB_PATH = "~/Library/Application Support/Reflect/File System/000/t/00/00000000";
 /**
  * Expands ~ to the user's home directory
  */
 export declare function expandPath(filePath: string): string;
+/**
+ * Searches for the Reflect local database file
+ * Returns the first valid database path found, or null if not found
+ */
+export declare function findLocalDatabase(): string | null;
+/**
+ * Gets the default database path, searching for it if not provided
+ */
+export declare function getDefaultDbPath(): string;
+export declare const DEFAULT_DB_PATH: string;
 /**
  * Strips HTML tags from a string, converting <br> to newlines
  */

package/dist/utils.js

@@ -3,8 +3,9 @@
  */
 import * as path from "path";
 import * as os from "os";
-// Reflect local database path
-export const DEFAULT_DB_PATH = "~/Library/Application Support/Reflect/File System/000/t/00/00000000";
+import * as fs from "fs";
+// Base path for Reflect local database
+const REFLECT_BASE_PATH = "~/Library/Application Support/Reflect/File System";
 /**
  * Expands ~ to the user's home directory
  */
@@ -14,6 +15,72 @@ export function expandPath(filePath) {
     }
     return filePath;
 }
+/**
+ * Searches for the Reflect local database file
+ * Returns the first valid database path found, or null if not found
+ */
+export function findLocalDatabase() {
+    const basePath = expandPath(REFLECT_BASE_PATH);
+    if (!fs.existsSync(basePath)) {
+        return null;
+    }
+    // Search for database files in the File System directory
+    // Structure is typically: File System/XXX/t/XX/XXXXXXXX
+    try {
+        const entries = fs.readdirSync(basePath);
+        for (const entry of entries) {
+            const entryPath = path.join(basePath, entry);
+            const tPath = path.join(entryPath, "t");
+            if (fs.existsSync(tPath) && fs.statSync(tPath).isDirectory()) {
+                // Look for subdirectories in t/
+                const tEntries = fs.readdirSync(tPath);
+                for (const tEntry of tEntries) {
+                    const subPath = path.join(tPath, tEntry);
+                    if (fs.statSync(subPath).isDirectory()) {
+                        // Look for database files (8-char hex names)
+                        const dbFiles = fs.readdirSync(subPath);
+                        for (const dbFile of dbFiles) {
+                            const dbPath = path.join(subPath, dbFile);
+                            // Check if it's a valid SQLite database (starts with SQLite header)
+                            if (fs.statSync(dbPath).isFile()) {
+                                try {
+                                    const header = Buffer.alloc(16);
+                                    const fd = fs.openSync(dbPath, 'r');
+                                    fs.readSync(fd, header, 0, 16, 0);
+                                    fs.closeSync(fd);
+                                    // SQLite files start with "SQLite format 3"
+                                    if (header.toString('utf8', 0, 15) === 'SQLite format 3') {
+                                        return dbPath;
+                                    }
+                                }
+                                catch {
+                                    // Not a readable file, skip
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/**
+ * Gets the default database path, searching for it if not provided
+ */
+export function getDefaultDbPath() {
+    const found = findLocalDatabase();
+    if (found) {
+        return found;
+    }
+    // Fallback to a common path pattern
+    return expandPath("~/Library/Application Support/Reflect/File System/000/t/00/00000000");
+}
+// For backwards compatibility
+export const DEFAULT_DB_PATH = getDefaultDbPath();
 /**
  * Strips HTML tags from a string, converting <br> to newlines
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reflect-mcp",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "MCP server for Reflect Notes - connect your notes to Claude Desktop. Just run: npx reflect-mcp",
   "type": "module",
   "main": "dist/server.js",
@@ -39,7 +39,7 @@
     "@modelcontextprotocol/sdk": "^1.25.1",
     "better-sqlite3": "^11.10.0",
     "fastmcp": "^3.25.4",
-    "reflect-mcp": "^1.0.3",
+    "reflect-mcp": "^1.0.9",
     "zod": "^4.1.13"
   },
   "devDependencies": {