NotebookLM MCP Server

/** * Cleanup Manager for NotebookLM MCP Server * * ULTRATHINK EDITION - Complete cleanup across all platforms! * * Handles safe removal of: * - Legacy data from notebooklm-mcp-nodejs * - Current installation data * - Browser profiles and session data * - NPM/NPX cache * - Claude CLI MCP logs * - Claude Projects cache * - Temporary backups * - Editor logs (Cursor, VSCode) * - Trash files (optional) * * Platform support: Linux, Windows, macOS */ import fs from "fs/promises"; import path from "path"; import { globby } from "globby"; import envPaths from "env-paths"; import os from "os"; import { log } from "./logger.js"; export type CleanupMode = "legacy" | "all" | "deep"; export interface CleanupResult { success: boolean; mode: CleanupMode; deletedPaths: string[]; failedPaths: string[]; totalSizeBytes: number; categorySummary: Record<string, { count: number; bytes: number }>; } export interface CleanupCategory { name: string; description: string; paths: string[]; totalBytes: number; optional: boolean; } interface Paths { data: string; config: string; cache: string; log: string; temp: string; } export class CleanupManager { private legacyPaths: Paths; private currentPaths: Paths; private homeDir: string; private tempDir: string; constructor() { // envPaths() does NOT create directories - it just returns path strings // IMPORTANT: envPaths() has a default suffix 'nodejs', so we must explicitly disable it! // Legacy paths with -nodejs suffix (using default suffix behavior) this.legacyPaths = envPaths("notebooklm-mcp"); // This becomes notebooklm-mcp-nodejs by default // Current paths without suffix (disable the default suffix with empty string) this.currentPaths = envPaths("notebooklm-mcp", {suffix: ""}); // Platform-agnostic paths this.homeDir = os.homedir(); this.tempDir = os.tmpdir(); } // ============================================================================ // Platform-Specific Path Resolution // ============================================================================ /** * Get NPM cache directory (platform-specific) */ private getNpmCachePath(): string { return path.join(this.homeDir, ".npm"); } /** * Get Claude CLI cache directory (platform-specific) */ private getClaudeCliCachePath(): string { const platform = process.platform; if (platform === "win32") { const localAppData = process.env.LOCALAPPDATA || path.join(this.homeDir, "AppData", "Local"); return path.join(localAppData, "claude-cli-nodejs"); } else if (platform === "darwin") { return path.join(this.homeDir, "Library", "Caches", "claude-cli-nodejs"); } else { // Linux and others return path.join(this.homeDir, ".cache", "claude-cli-nodejs"); } } /** * Get Claude projects directory (platform-specific) */ private getClaudeProjectsPath(): string { const platform = process.platform; if (platform === "win32") { const appData = process.env.APPDATA || path.join(this.homeDir, "AppData", "Roaming"); return path.join(appData, ".claude", "projects"); } else if (platform === "darwin") { return path.join(this.homeDir, "Library", "Application Support", "claude", "projects"); } else { // Linux and others return path.join(this.homeDir, ".claude", "projects"); } } /** * Get editor config paths (Cursor, VSCode) */ private getEditorConfigPaths(): string[] { const platform = process.platform; const paths: string[] = []; if (platform === "win32") { const appData = process.env.APPDATA || path.join(this.homeDir, "AppData", "Roaming"); paths.push( path.join(appData, "Cursor", "logs"), path.join(appData, "Code", "logs") ); } else if (platform === "darwin") { paths.push( path.join(this.homeDir, "Library", "Application Support", "Cursor", "logs"), path.join(this.homeDir, "Library", "Application Support", "Code", "logs") ); } else { // Linux paths.push( path.join(this.homeDir, ".config", "Cursor", "logs"), path.join(this.homeDir, ".config", "Code", "logs") ); } return paths; } /** * Get trash directory (platform-specific) */ private getTrashPath(): string | null { const platform = process.platform; if (platform === "darwin") { return path.join(this.homeDir, ".Trash"); } else if (platform === "linux") { return path.join(this.homeDir, ".local", "share", "Trash"); } else { // Windows Recycle Bin is complex, skip for now return null; } } /** * Get manual legacy config paths that might not be caught by envPaths * This ensures we catch ALL legacy installations including old config.json files */ private getManualLegacyPaths(): string[] { const paths: string[] = []; const platform = process.platform; if (platform === "linux") { // Linux-specific paths paths.push( path.join(this.homeDir, ".config", "notebooklm-mcp"), path.join(this.homeDir, ".config", "notebooklm-mcp-nodejs"), path.join(this.homeDir, ".local", "share", "notebooklm-mcp"), path.join(this.homeDir, ".local", "share", "notebooklm-mcp-nodejs"), path.join(this.homeDir, ".cache", "notebooklm-mcp"), path.join(this.homeDir, ".cache", "notebooklm-mcp-nodejs"), path.join(this.homeDir, ".local", "state", "notebooklm-mcp"), path.join(this.homeDir, ".local", "state", "notebooklm-mcp-nodejs") ); } else if (platform === "darwin") { // macOS-specific paths paths.push( path.join(this.homeDir, "Library", "Application Support", "notebooklm-mcp"), path.join(this.homeDir, "Library", "Application Support", "notebooklm-mcp-nodejs"), path.join(this.homeDir, "Library", "Preferences", "notebooklm-mcp"), path.join(this.homeDir, "Library", "Preferences", "notebooklm-mcp-nodejs"), path.join(this.homeDir, "Library", "Caches", "notebooklm-mcp"), path.join(this.homeDir, "Library", "Caches", "notebooklm-mcp-nodejs"), path.join(this.homeDir, "Library", "Logs", "notebooklm-mcp"), path.join(this.homeDir, "Library", "Logs", "notebooklm-mcp-nodejs") ); } else if (platform === "win32") { // Windows-specific paths const localAppData = process.env.LOCALAPPDATA || path.join(this.homeDir, "AppData", "Local"); const appData = process.env.APPDATA || path.join(this.homeDir, "AppData", "Roaming"); paths.push( path.join(localAppData, "notebooklm-mcp"), path.join(localAppData, "notebooklm-mcp-nodejs"), path.join(appData, "notebooklm-mcp"), path.join(appData, "notebooklm-mcp-nodejs") ); } return paths; } // ============================================================================ // Search Methods for Different File Types // ============================================================================ /** * Find NPM/NPX cache files */ private async findNpmCache(): Promise<string[]> { const found: string[] = []; try { const npmCachePath = this.getNpmCachePath(); const npxPath = path.join(npmCachePath, "_npx"); if (!(await this.pathExists(npxPath))) { return found; } // Search for notebooklm-mcp in npx cache const pattern = path.join(npxPath, "*/node_modules/notebooklm-mcp"); const matches = await globby(pattern, { onlyDirectories: true, absolute: true }); found.push(...matches); } catch (error) { log.warning(`⚠️ Error searching NPM cache: ${error}`); } return found; } /** * Find Claude CLI MCP logs */ private async findClaudeCliLogs(): Promise<string[]> { const found: string[] = []; try { const claudeCliPath = this.getClaudeCliCachePath(); if (!(await this.pathExists(claudeCliPath))) { return found; } // Search for notebooklm MCP logs const patterns = [ path.join(claudeCliPath, "*/mcp-logs-notebooklm"), path.join(claudeCliPath, "*notebooklm-mcp*"), ]; for (const pattern of patterns) { const matches = await globby(pattern, { onlyDirectories: true, absolute: true }); found.push(...matches); } } catch (error) { log.warning(`⚠️ Error searching Claude CLI cache: ${error}`); } return found; } /** * Find Claude projects cache */ private async findClaudeProjects(): Promise<string[]> { const found: string[] = []; try { const projectsPath = this.getClaudeProjectsPath(); if (!(await this.pathExists(projectsPath))) { return found; } // Search for notebooklm-mcp projects const pattern = path.join(projectsPath, "*notebooklm-mcp*"); const matches = await globby(pattern, { onlyDirectories: true, absolute: true }); found.push(...matches); } catch (error) { log.warning(`⚠️ Error searching Claude projects: ${error}`); } return found; } /** * Find temporary backups */ private async findTemporaryBackups(): Promise<string[]> { const found: string[] = []; try { // Search for notebooklm backup directories in temp const pattern = path.join(this.tempDir, "notebooklm-backup-*"); const matches = await globby(pattern, { onlyDirectories: true, absolute: true }); found.push(...matches); } catch (error) { log.warning(`⚠️ Error searching temp backups: ${error}`); } return found; } /** * Find editor logs (Cursor, VSCode) */ private async findEditorLogs(): Promise<string[]> { const found: string[] = []; try { const editorPaths = this.getEditorConfigPaths(); for (const editorPath of editorPaths) { if (!(await this.pathExists(editorPath))) { continue; } // Search for MCP notebooklm logs const pattern = path.join(editorPath, "**/exthost/**/*notebooklm*.log"); const matches = await globby(pattern, { onlyFiles: true, absolute: true }); found.push(...matches); } } catch (error) { log.warning(`⚠️ Error searching editor logs: ${error}`); } return found; } /** * Find trash files */ private async findTrashFiles(): Promise<string[]> { const found: string[] = []; try { const trashPath = this.getTrashPath(); if (!trashPath || !(await this.pathExists(trashPath))) { return found; } // Search for notebooklm files in trash const patterns = [ path.join(trashPath, "**/*notebooklm*"), ]; for (const pattern of patterns) { const matches = await globby(pattern, { absolute: true }); found.push(...matches); } } catch (error) { log.warning(`⚠️ Error searching trash: ${error}`); } return found; } // ============================================================================ // Main Cleanup Methods // ============================================================================ /** * Get all paths that would be deleted for a given mode (with categorization) */ async getCleanupPaths( mode: CleanupMode, preserveLibrary: boolean = false ): Promise<{ categories: CleanupCategory[]; totalPaths: string[]; totalSizeBytes: number; }> { const categories: CleanupCategory[] = []; const allPaths: Set<string> = new Set(); let totalSizeBytes = 0; // Category 1: Legacy Paths (notebooklm-mcp-nodejs & manual legacy paths) if (mode === "legacy" || mode === "all" || mode === "deep") { const legacyPaths: string[] = []; let legacyBytes = 0; // Check envPaths-based legacy directories const legacyDirs = [ this.legacyPaths.data, this.legacyPaths.config, this.legacyPaths.cache, this.legacyPaths.log, this.legacyPaths.temp, ]; for (const dir of legacyDirs) { if (await this.pathExists(dir)) { const size = await this.getDirectorySize(dir); legacyPaths.push(dir); legacyBytes += size; allPaths.add(dir); } } // CRITICAL: Also check manual legacy paths to catch old config.json files // and any paths that envPaths might miss const manualLegacyPaths = this.getManualLegacyPaths(); for (const dir of manualLegacyPaths) { if (await this.pathExists(dir) && !allPaths.has(dir)) { const size = await this.getDirectorySize(dir); legacyPaths.push(dir); legacyBytes += size; allPaths.add(dir); } } if (legacyPaths.length > 0) { categories.push({ name: "Legacy Installation (notebooklm-mcp-nodejs)", description: "Old installation data with -nodejs suffix and legacy config files", paths: legacyPaths, totalBytes: legacyBytes, optional: false, }); totalSizeBytes += legacyBytes; } } // Category 2: Current Installation if (mode === "all" || mode === "deep") { const currentPaths: string[] = []; let currentBytes = 0; // If preserveLibrary is true, don't delete the data directory itself // Instead, only delete subdirectories const currentDirs = preserveLibrary ? [ // Don't include data directory to preserve library.json this.currentPaths.config, this.currentPaths.cache, this.currentPaths.log, this.currentPaths.temp, // Only delete subdirectories, not the parent path.join(this.currentPaths.data, "browser_state"), path.join(this.currentPaths.data, "chrome_profile"), path.join(this.currentPaths.data, "chrome_profile_instances"), ] : [ // Delete everything including data directory this.currentPaths.data, this.currentPaths.config, this.currentPaths.cache, this.currentPaths.log, this.currentPaths.temp, // Specific subdirectories (only if parent doesn't exist) path.join(this.currentPaths.data, "browser_state"), path.join(this.currentPaths.data, "chrome_profile"), path.join(this.currentPaths.data, "chrome_profile_instances"), ]; for (const dir of currentDirs) { if (await this.pathExists(dir) && !allPaths.has(dir)) { const size = await this.getDirectorySize(dir); currentPaths.push(dir); currentBytes += size; allPaths.add(dir); } } if (currentPaths.length > 0) { const description = preserveLibrary ? "Active installation data and browser profiles (library.json will be preserved)" : "Active installation data and browser profiles"; categories.push({ name: "Current Installation (notebooklm-mcp)", description, paths: currentPaths, totalBytes: currentBytes, optional: false, }); totalSizeBytes += currentBytes; } } // Category 3: NPM Cache if (mode === "all" || mode === "deep") { const npmPaths = await this.findNpmCache(); if (npmPaths.length > 0) { let npmBytes = 0; for (const p of npmPaths) { if (!allPaths.has(p)) { npmBytes += await this.getDirectorySize(p); allPaths.add(p); } } if (npmBytes > 0) { categories.push({ name: "NPM/NPX Cache", description: "NPX cached installations of notebooklm-mcp", paths: npmPaths, totalBytes: npmBytes, optional: false, }); totalSizeBytes += npmBytes; } } } // Category 4: Claude CLI Logs if (mode === "all" || mode === "deep") { const claudeCliPaths = await this.findClaudeCliLogs(); if (claudeCliPaths.length > 0) { let claudeCliBytes = 0; for (const p of claudeCliPaths) { if (!allPaths.has(p)) { claudeCliBytes += await this.getDirectorySize(p); allPaths.add(p); } } if (claudeCliBytes > 0) { categories.push({ name: "Claude CLI MCP Logs", description: "MCP server logs from Claude CLI", paths: claudeCliPaths, totalBytes: claudeCliBytes, optional: false, }); totalSizeBytes += claudeCliBytes; } } } // Category 5: Temporary Backups if (mode === "all" || mode === "deep") { const backupPaths = await this.findTemporaryBackups(); if (backupPaths.length > 0) { let backupBytes = 0; for (const p of backupPaths) { if (!allPaths.has(p)) { backupBytes += await this.getDirectorySize(p); allPaths.add(p); } } if (backupBytes > 0) { categories.push({ name: "Temporary Backups", description: "Temporary backup directories in system temp", paths: backupPaths, totalBytes: backupBytes, optional: false, }); totalSizeBytes += backupBytes; } } } // Category 6: Claude Projects (deep mode only) if (mode === "deep") { const projectPaths = await this.findClaudeProjects(); if (projectPaths.length > 0) { let projectBytes = 0; for (const p of projectPaths) { if (!allPaths.has(p)) { projectBytes += await this.getDirectorySize(p); allPaths.add(p); } } if (projectBytes > 0) { categories.push({ name: "Claude Projects Cache", description: "Project-specific cache in Claude config", paths: projectPaths, totalBytes: projectBytes, optional: true, }); totalSizeBytes += projectBytes; } } } // Category 7: Editor Logs (deep mode only) if (mode === "deep") { const editorPaths = await this.findEditorLogs(); if (editorPaths.length > 0) { let editorBytes = 0; for (const p of editorPaths) { if (!allPaths.has(p)) { editorBytes += await this.getFileSize(p); allPaths.add(p); } } if (editorBytes > 0) { categories.push({ name: "Editor Logs (Cursor/VSCode)", description: "MCP logs from code editors", paths: editorPaths, totalBytes: editorBytes, optional: true, }); totalSizeBytes += editorBytes; } } } // Category 8: Trash Files (deep mode only) if (mode === "deep") { const trashPaths = await this.findTrashFiles(); if (trashPaths.length > 0) { let trashBytes = 0; for (const p of trashPaths) { if (!allPaths.has(p)) { trashBytes += await this.getFileSize(p); allPaths.add(p); } } if (trashBytes > 0) { categories.push({ name: "Trash Files", description: "Deleted notebooklm files in system trash", paths: trashPaths, totalBytes: trashBytes, optional: true, }); totalSizeBytes += trashBytes; } } } return { categories, totalPaths: Array.from(allPaths), totalSizeBytes, }; } /** * Perform cleanup with safety checks and detailed reporting */ async performCleanup( mode: CleanupMode, preserveLibrary: boolean = false ): Promise<CleanupResult> { log.info(`🧹 Starting cleanup in "${mode}" mode...`); if (preserveLibrary) { log.info(`📚 Library preservation enabled - library.json will be kept!`); } const { categories, totalSizeBytes } = await this.getCleanupPaths(mode, preserveLibrary); const deletedPaths: string[] = []; const failedPaths: string[] = []; const categorySummary: Record<string, { count: number; bytes: number }> = {}; // Delete by category for (const category of categories) { log.info(`\n📦 ${category.name} (${category.paths.length} items, ${this.formatBytes(category.totalBytes)})`); if (category.optional) { log.warning(` ⚠️ Optional category - ${category.description}`); } let categoryDeleted = 0; let categoryBytes = 0; for (const itemPath of category.paths) { try { if (await this.pathExists(itemPath)) { const size = await this.getDirectorySize(itemPath); log.info(` 🗑️ Deleting: ${itemPath}`); await fs.rm(itemPath, { recursive: true, force: true }); deletedPaths.push(itemPath); categoryDeleted++; categoryBytes += size; log.success(` ✅ Deleted: ${itemPath} (${this.formatBytes(size)})`); } } catch (error) { log.error(` ❌ Failed to delete: ${itemPath} - ${error}`); failedPaths.push(itemPath); } } categorySummary[category.name] = { count: categoryDeleted, bytes: categoryBytes, }; } const success = failedPaths.length === 0; if (success) { log.success(`\n✅ Cleanup complete! Deleted ${deletedPaths.length} items (${this.formatBytes(totalSizeBytes)})`); } else { log.warning(`\n⚠️ Cleanup completed with ${failedPaths.length} errors`); log.success(` Deleted: ${deletedPaths.length} items`); log.error(` Failed: ${failedPaths.length} items`); } return { success, mode, deletedPaths, failedPaths, totalSizeBytes, categorySummary, }; } // ============================================================================ // Helper Methods // ============================================================================ /** * Check if a path exists */ private async pathExists(dirPath: string): Promise<boolean> { try { await fs.access(dirPath); return true; } catch { return false; } } /** * Get the size of a single file */ private async getFileSize(filePath: string): Promise<number> { try { const stats = await fs.stat(filePath); return stats.size; } catch { return 0; } } /** * Get the total size of a directory (recursive) */ private async getDirectorySize(dirPath: string): Promise<number> { try { const stats = await fs.stat(dirPath); if (!stats.isDirectory()) { return stats.size; } let totalSize = 0; const files = await fs.readdir(dirPath); for (const file of files) { const filePath = path.join(dirPath, file); const fileStats = await fs.stat(filePath); if (fileStats.isDirectory()) { totalSize += await this.getDirectorySize(filePath); } else { totalSize += fileStats.size; } } return totalSize; } catch { return 0; } } /** * Format bytes to human-readable string */ formatBytes(bytes: number): string { if (bytes === 0) return "0 Bytes"; const k = 1024; const sizes = ["Bytes", "KB", "MB", "GB"]; const i = Math.floor(Math.log(bytes) / Math.log(k)); return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i]; } /** * Get platform-specific path info */ getPlatformInfo(): { platform: string; legacyBasePath: string; currentBasePath: string; npmCachePath: string; claudeCliCachePath: string; claudeProjectsPath: string; } { const platform = process.platform; let platformName = "Unknown"; switch (platform) { case "win32": platformName = "Windows"; break; case "darwin": platformName = "macOS"; break; case "linux": platformName = "Linux"; break; } return { platform: platformName, legacyBasePath: this.legacyPaths.data, currentBasePath: this.currentPaths.data, npmCachePath: this.getNpmCachePath(), claudeCliCachePath: this.getClaudeCliCachePath(), claudeProjectsPath: this.getClaudeProjectsPath(), }; } }