reflect-mcp 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,78 @@
+# Reflect MCP Server
+
+Connect your [Reflect](https://reflect.app) notes to Claude Desktop.
+
+## Quick Start
+
+**1. Install the server:**
+```bash
+npx reflect-mcp install
+```
+
+**2. Add to Claude Desktop config** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "reflect": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "http://localhost:3000/mcp"]
+    }
+  }
+}
+```
+
+**3. Restart Claude Desktop**
+
+That's it! First time you use a Reflect tool, your browser will open to authenticate.
+
+## Commands
+
+```bash
+reflect-mcp install [db-path]    # Install as auto-start service
+reflect-mcp uninstall            # Remove auto-start service
+reflect-mcp status               # Check service status
+reflect-mcp [db-path]            # Run server manually
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `db-path` | Path to Reflect SQLite database | `~/Library/Application Support/Reflect/File System/000/t/00/00000000` |
+| `--port <port>` | Server port | `3000` |
+
+## Examples
+
+```bash
+# Install with default settings
+npx reflect-mcp install
+
+# Install with custom database path
+npx reflect-mcp install ~/custom/path/to/reflect/db
+
+# Install with custom port
+npx reflect-mcp install --port 4000
+
+# Check if service is running
+npx reflect-mcp status
+
+# Remove auto-start
+npx reflect-mcp uninstall
+```
+
+## Tools Available
+
+- `get_graphs` - List all Reflect graphs
+- `get_backlinks` - Get backlinks for a note
+- `get_daily_notes` - Get recent daily notes
+- `get_daily_note_by_date` - Get daily note for specific date
+- `get_backlinked_notes` - Get notes with most backlinks
+- `get_tags` - Get all tags with usage counts
+- `get_notes_with_tag` - Get notes with a specific tag
+- `get_note` - Get a note by title
+- `create_note` - Create a new note
+
+## License
+
+MIT
+

package/dist/cli.d.ts

@@ -3,5 +3,6 @@
  * Reflect MCP Server - CLI Entry Point
  *
  * Run with: npx reflect-mcp <db-path>
+ * Install: npx reflect-mcp install <db-path>
  */
 export {};

package/dist/cli.js

@@ -3,54 +3,212 @@
  * Reflect MCP Server - CLI Entry Point
  *
  * Run with: npx reflect-mcp <db-path>
+ * Install: npx reflect-mcp install <db-path>
  */
 import { startReflectMCPServer } from "./server.js";
-import { DEFAULT_DB_PATH } from "./utils.js";
+import { DEFAULT_DB_PATH, expandPath } from "./utils.js";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import { execSync } from "child_process";
 const REFLECT_CLIENT_ID = "55798f25d5a24efb95e4174fff3d219e";
-// Parse command line arguments
-function parseArgs() {
-    const args = process.argv.slice(2);
-    let dbPath = DEFAULT_DB_PATH;
-    let port = 3000;
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === "--port" && args[i + 1]) {
-            port = parseInt(args[++i]);
-        }
-        else if (args[i] === "--help" || args[i] === "-h") {
-            console.log(`
-Usage: reflect-mcp [db-path] [options]
+const LAUNCH_AGENT_LABEL = "com.reflect-mcp";
+const LAUNCH_AGENT_DIR = path.join(os.homedir(), "Library/LaunchAgents");
+const LAUNCH_AGENT_PATH = path.join(LAUNCH_AGENT_DIR, `${LAUNCH_AGENT_LABEL}.plist`);
+// Get the command and arguments
+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);
+}
+function showHelp() {
+    console.log(`
+Reflect MCP Server - Connect your Reflect notes to Claude
+
+Usage:
+  reflect-mcp [db-path] [--port <port>]     Run the server
+  reflect-mcp install [db-path]             Install as auto-start service
+  reflect-mcp uninstall                     Remove auto-start service
+  reflect-mcp status                        Check service status
 
 Arguments:
-  db-path           Path to Reflect SQLite database
-                    (default: ${DEFAULT_DB_PATH})
+  db-path     Path to Reflect SQLite database
+              (default: ${DEFAULT_DB_PATH})
 
 Options:
-  --port <port>     Port to run server on (default: 3000)
-  --help, -h        Show this help message
+  --port <port>   Port to run server on (default: 3000)
 
 Examples:
-  npx reflect-mcp
-  npx reflect-mcp ~/Library/Application\\ Support/Reflect/File\\ System/000/t/00/00000000
-  npx reflect-mcp /path/to/reflect/db --port 4000
+  reflect-mcp install                       # Install with default db path
+  reflect-mcp install ~/my/reflect/db       # Install with custom db path
+  reflect-mcp uninstall                     # Remove auto-start
+  reflect-mcp                               # Run server manually
 `);
-            process.exit(0);
+    process.exit(0);
+}
+function install(installArgs) {
+    let dbPath = DEFAULT_DB_PATH;
+    let port = 3000;
+    // Parse install arguments
+    for (let i = 0; i < installArgs.length; i++) {
+        if (installArgs[i] === "--port" && installArgs[i + 1]) {
+            port = parseInt(installArgs[++i]);
         }
-        else if (!args[i].startsWith("--")) {
-            // Positional argument = db path
-            dbPath = args[i];
+        else if (!installArgs[i].startsWith("--")) {
+            dbPath = installArgs[i];
         }
     }
-    return { dbPath, port };
-}
-const { dbPath, port: PORT } = parseArgs();
-startReflectMCPServer({
-    clientId: REFLECT_CLIENT_ID,
-    port: PORT,
-    dbPath,
-}).then(() => {
-    console.log(`Reflect MCP Server running on http://localhost:${PORT}`);
-    console.log(`Database: ${dbPath}`);
-}).catch((err) => {
-    console.error("Failed to start server:", err);
-    process.exit(1);
-});
+    const expandedDbPath = expandPath(dbPath);
+    const nodePath = process.execPath;
+    const cliPath = process.argv[1];
+    console.log("📦 Installing Reflect MCP Server as auto-start service...\n");
+    // Create Launch Agent directory if needed
+    if (!fs.existsSync(LAUNCH_AGENT_DIR)) {
+        fs.mkdirSync(LAUNCH_AGENT_DIR, { recursive: true });
+    }
+    // Stop existing service if running
+    try {
+        execSync(`launchctl stop ${LAUNCH_AGENT_LABEL} 2>/dev/null`, { stdio: "ignore" });
+        execSync(`launchctl unload ${LAUNCH_AGENT_PATH} 2>/dev/null`, { stdio: "ignore" });
+    }
+    catch {
+        // Ignore errors - service might not exist yet
+    }
+    // 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">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${LAUNCH_AGENT_LABEL}</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>${nodePath}</string>
+        <string>${cliPath}</string>
+        <string>${expandedDbPath}</string>
+        <string>--port</string>
+        <string>${port}</string>
+    </array>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardErrorPath</key>
+    <string>/tmp/reflect-mcp.log</string>
+    <key>StandardOutPath</key>
+    <string>/tmp/reflect-mcp.log</string>
+</dict>
+</plist>`;
+    // Write plist file
+    fs.writeFileSync(LAUNCH_AGENT_PATH, plist);
+    console.log(`✅ Created: ${LAUNCH_AGENT_PATH}`);
+    // Load and start the service
+    try {
+        execSync(`launchctl load ${LAUNCH_AGENT_PATH}`);
+        execSync(`launchctl start ${LAUNCH_AGENT_LABEL}`);
+        console.log("✅ Service installed and started!\n");
+    }
+    catch (error) {
+        console.error("❌ Failed to start service:", error);
+        process.exit(1);
+    }
+    console.log(`🚀 Reflect MCP Server will now auto-start on login`);
+    console.log(`   Server: http://localhost:${port}`);
+    console.log(`   Database: ${expandedDbPath}`);
+    console.log(`   Logs: tail -f /tmp/reflect-mcp.log\n`);
+    console.log(`📋 Add to Claude Desktop config (~/.config/claude/claude_desktop_config.json):`);
+    console.log(`{
+  "mcpServers": {
+    "reflect": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "http://localhost:${port}/mcp"]
+    }
+  }
+}`);
+}
+function uninstall() {
+    console.log("🗑️  Removing Reflect MCP Server auto-start service...\n");
+    try {
+        execSync(`launchctl stop ${LAUNCH_AGENT_LABEL} 2>/dev/null`, { stdio: "ignore" });
+        execSync(`launchctl unload ${LAUNCH_AGENT_PATH} 2>/dev/null`, { stdio: "ignore" });
+    }
+    catch {
+        // Ignore errors
+    }
+    if (fs.existsSync(LAUNCH_AGENT_PATH)) {
+        fs.unlinkSync(LAUNCH_AGENT_PATH);
+        console.log(`✅ Removed: ${LAUNCH_AGENT_PATH}`);
+    }
+    console.log("✅ Service uninstalled. Server will no longer auto-start.");
+}
+function status() {
+    console.log("📊 Reflect MCP Server Status\n");
+    // Check if plist exists
+    if (fs.existsSync(LAUNCH_AGENT_PATH)) {
+        console.log(`✅ Launch Agent installed: ${LAUNCH_AGENT_PATH}`);
+    }
+    else {
+        console.log("❌ Launch Agent not installed");
+        console.log("   Run: reflect-mcp install");
+        return;
+    }
+    // Check if service is running
+    try {
+        const result = execSync(`launchctl list | grep ${LAUNCH_AGENT_LABEL}`, { encoding: "utf-8" });
+        if (result.includes(LAUNCH_AGENT_LABEL)) {
+            const parts = result.trim().split(/\s+/);
+            const pid = parts[0];
+            const exitCode = parts[1];
+            if (pid !== "-") {
+                console.log(`✅ Service running (PID: ${pid})`);
+            }
+            else if (exitCode === "0") {
+                console.log("⚠️  Service stopped (last exit: success)");
+            }
+            else {
+                console.log(`❌ Service stopped (last exit code: ${exitCode})`);
+            }
+        }
+    }
+    catch {
+        console.log("❌ Service not loaded");
+    }
+    console.log(`\n📝 Logs: tail -f /tmp/reflect-mcp.log`);
+}
+function runServer(serverArgs) {
+    let dbPath = DEFAULT_DB_PATH;
+    let port = 3000;
+    for (let i = 0; i < serverArgs.length; i++) {
+        if (serverArgs[i] === "--port" && serverArgs[i + 1]) {
+            port = parseInt(serverArgs[++i]);
+        }
+        else if (!serverArgs[i].startsWith("--")) {
+            dbPath = serverArgs[i];
+        }
+    }
+    startReflectMCPServer({
+        clientId: REFLECT_CLIENT_ID,
+        port,
+        dbPath,
+    }).then(() => {
+        console.log(`Reflect MCP Server running on http://localhost:${port}`);
+        console.log(`Database: ${dbPath}`);
+    }).catch((err) => {
+        console.error("Failed to start server:", err);
+        process.exit(1);
+    });
+}

package/dist/pkcehandler.d.ts

@@ -82,6 +82,7 @@ export declare class PKCEOAuthProxy {
         redirect_uris?: string[];
     }>;
     loadUpstreamTokens(proxyToken: string): TokenData | null;
+    getFirstValidToken(): TokenData | null;
     private startCleanup;
     destroy(): void;
 }

package/dist/pkcehandler.js

@@ -281,6 +281,16 @@ export class PKCEOAuthProxy {
         }
         return data;
     }
+    // Get first valid token (for stdio mode where we don't have specific token ID)
+    getFirstValidToken() {
+        const now = new Date();
+        for (const [id, token] of this.tokens) {
+            if (token.expiresAt > now) {
+                return token;
+            }
+        }
+        return null;
+    }
     // Cleanup expired transactions and tokens
     startCleanup() {
         this.cleanupInterval = setInterval(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reflect-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP server for Reflect Notes - connect your notes to Claude Desktop. Just run: npx reflect-mcp",
   "type": "module",
   "main": "dist/server.js",
@@ -15,7 +15,8 @@
     "build": "tsc",
     "dev": "tsx src/cli.ts",
     "start": "node dist/cli.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "postinstall": "npm rebuild better-sqlite3 || true"
   },
   "keywords": [
     "mcp",
@@ -35,7 +36,8 @@
     "node": ">=18"
   },
   "dependencies": {
-    "better-sqlite3": "^11.0.0",
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "better-sqlite3": "^11.10.0",
     "fastmcp": "^3.25.4",
     "zod": "^4.1.13"
   },