@pan-sec/notebooklm-mcp 1.4.0

package/dist/index.js

@@ -0,0 +1,371 @@
+#!/usr/bin/env node
+/**
+ * NotebookLM MCP Server
+ *
+ * MCP Server for Google NotebookLM - Chat with Gemini 2.5 through NotebookLM
+ * with session support and human-like behavior!
+ *
+ * Features:
+ * - Session-based contextual conversations
+ * - Auto re-login on session expiry
+ * - Human-like typing and mouse movements
+ * - Persistent browser fingerprint
+ * - Stealth mode with Patchright
+ * - Claude Code integration via npx
+ *
+ * Usage:
+ *   npx notebooklm-mcp
+ *   node dist/index.js
+ *
+ * Environment Variables:
+ *   NOTEBOOK_URL - Default NotebookLM notebook URL
+ *   AUTO_LOGIN_ENABLED - Enable automatic login (true/false)
+ *   LOGIN_EMAIL - Google email for auto-login
+ *   LOGIN_PASSWORD - Google password for auto-login
+ *   HEADLESS - Run browser in headless mode (true/false)
+ *   MAX_SESSIONS - Maximum concurrent sessions (default: 10)
+ *   SESSION_TIMEOUT - Session timeout in seconds (default: 900)
+ *
+ * Based on the Python NotebookLM API implementation
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { AuthManager } from "./auth/auth-manager.js";
+import { SessionManager } from "./session/session-manager.js";
+import { NotebookLibrary } from "./library/notebook-library.js";
+import { ToolHandlers, buildToolDefinitions } from "./tools/index.js";
+import { ResourceHandlers } from "./resources/resource-handlers.js";
+import { SettingsManager } from "./utils/settings-manager.js";
+import { CliHandler } from "./utils/cli-handler.js";
+import { CONFIG } from "./config.js";
+import { log } from "./utils/logger.js";
+import { audit, getAuditLogger } from "./utils/audit-logger.js";
+import { checkSecurityContext } from "./utils/security.js";
+import { getMCPAuthenticator, authenticateMCPRequest } from "./auth/mcp-auth.js";
+/**
+ * Main MCP Server Class
+ */
+class NotebookLMMCPServer {
+    server;
+    authManager;
+    sessionManager;
+    library;
+    toolHandlers;
+    resourceHandlers;
+    settingsManager;
+    toolDefinitions;
+    constructor() {
+        // Initialize MCP Server
+        this.server = new Server({
+            name: "notebooklm-mcp",
+            version: "1.1.0",
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+                resourceTemplates: {},
+                prompts: {}, // Required for completion/complete support in some clients
+                logging: {},
+            },
+        });
+        // Initialize managers
+        this.authManager = new AuthManager();
+        this.sessionManager = new SessionManager(this.authManager);
+        this.library = new NotebookLibrary();
+        this.settingsManager = new SettingsManager();
+        // Initialize handlers
+        this.toolHandlers = new ToolHandlers(this.sessionManager, this.authManager, this.library);
+        this.resourceHandlers = new ResourceHandlers(this.library);
+        // Build and Filter tool definitions
+        const allTools = buildToolDefinitions(this.library);
+        this.toolDefinitions = this.settingsManager.filterTools(allTools);
+        // Setup handlers
+        this.setupHandlers();
+        this.setupShutdownHandlers();
+        const activeSettings = this.settingsManager.getEffectiveSettings();
+        log.info("🚀 NotebookLM MCP Server initialized");
+        log.info(`  Version: 1.1.0`);
+        log.info(`  Node: ${process.version}`);
+        log.info(`  Platform: ${process.platform}`);
+        log.info(`  Profile: ${activeSettings.profile} (${this.toolDefinitions.length} tools active)`);
+    }
+    /**
+     * Setup MCP request handlers
+     */
+    setupHandlers() {
+        // Register Resource Handlers (Resources, Templates, Completions)
+        this.resourceHandlers.registerHandlers(this.server);
+        // List available tools
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            log.info("📋 [MCP] list_tools request received");
+            return {
+                tools: this.toolDefinitions,
+            };
+        });
+        // Handle tool calls
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            const progressToken = args?._meta?.progressToken;
+            const authToken = args?._meta?.authToken || process.env.NLMCP_AUTH_TOKEN;
+            log.info(`🔧 [MCP] Tool call: ${name}`);
+            if (progressToken) {
+                log.info(`  📊 Progress token: ${progressToken}`);
+            }
+            // === SECURITY: MCP Authentication ===
+            const authResult = await authenticateMCPRequest(authToken, name);
+            if (!authResult.authenticated) {
+                log.warning(`🔒 [MCP] Authentication failed for tool: ${name}`);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: authResult.error || "Authentication required",
+                            }),
+                        },
+                    ],
+                };
+            }
+            // Create progress callback function
+            const sendProgress = async (message, progress, total) => {
+                if (progressToken) {
+                    await this.server.notification({
+                        method: "notifications/progress",
+                        params: {
+                            progressToken,
+                            message,
+                            ...(progress !== undefined && { progress }),
+                            ...(total !== undefined && { total }),
+                        },
+                    });
+                    log.dim(`  📊 Progress: ${message}`);
+                }
+            };
+            try {
+                let result;
+                switch (name) {
+                    case "ask_question":
+                        result = await this.toolHandlers.handleAskQuestion(args, sendProgress);
+                        break;
+                    case "add_notebook":
+                        result = await this.toolHandlers.handleAddNotebook(args);
+                        break;
+                    case "list_notebooks":
+                        result = await this.toolHandlers.handleListNotebooks();
+                        break;
+                    case "get_notebook":
+                        result = await this.toolHandlers.handleGetNotebook(args);
+                        break;
+                    case "select_notebook":
+                        result = await this.toolHandlers.handleSelectNotebook(args);
+                        break;
+                    case "update_notebook":
+                        result = await this.toolHandlers.handleUpdateNotebook(args);
+                        break;
+                    case "remove_notebook":
+                        result = await this.toolHandlers.handleRemoveNotebook(args);
+                        break;
+                    case "search_notebooks":
+                        result = await this.toolHandlers.handleSearchNotebooks(args);
+                        break;
+                    case "get_library_stats":
+                        result = await this.toolHandlers.handleGetLibraryStats();
+                        break;
+                    case "list_sessions":
+                        result = await this.toolHandlers.handleListSessions();
+                        break;
+                    case "close_session":
+                        result = await this.toolHandlers.handleCloseSession(args);
+                        break;
+                    case "reset_session":
+                        result = await this.toolHandlers.handleResetSession(args);
+                        break;
+                    case "get_health":
+                        result = await this.toolHandlers.handleGetHealth();
+                        break;
+                    case "setup_auth":
+                        result = await this.toolHandlers.handleSetupAuth(args, sendProgress);
+                        break;
+                    case "re_auth":
+                        result = await this.toolHandlers.handleReAuth(args, sendProgress);
+                        break;
+                    case "cleanup_data":
+                        result = await this.toolHandlers.handleCleanupData(args);
+                        break;
+                    default:
+                        log.error(`❌ [MCP] Unknown tool: ${name}`);
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        success: false,
+                                        error: `Unknown tool: ${name}`,
+                                    }, null, 2),
+                                },
+                            ],
+                        };
+                }
+                // Return result
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                log.error(`❌ [MCP] Tool execution error: ${errorMessage}`);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+        });
+    }
+    /**
+     * Setup graceful shutdown handlers
+     */
+    setupShutdownHandlers() {
+        let shuttingDown = false;
+        const shutdown = async (signal) => {
+            if (shuttingDown) {
+                return;
+            }
+            shuttingDown = true;
+            log.info(`\n🛑 Received ${signal}, shutting down gracefully...`);
+            try {
+                // Cleanup tool handlers (closes all sessions)
+                await this.toolHandlers.cleanup();
+                // Close server
+                await this.server.close();
+                log.success("✅ Shutdown complete");
+                process.exit(0);
+            }
+            catch (error) {
+                log.error(`❌ Error during shutdown: ${error}`);
+                process.exit(1);
+            }
+        };
+        const requestShutdown = (signal) => {
+            void shutdown(signal);
+        };
+        process.on("SIGINT", () => requestShutdown("SIGINT"));
+        process.on("SIGTERM", () => requestShutdown("SIGTERM"));
+        process.on("uncaughtException", (error) => {
+            log.error(`💥 Uncaught exception: ${error}`);
+            log.error(error.stack || "");
+            requestShutdown("uncaughtException");
+        });
+        process.on("unhandledRejection", (reason, promise) => {
+            log.error(`💥 Unhandled rejection at: ${promise}`);
+            log.error(`Reason: ${reason}`);
+            requestShutdown("unhandledRejection");
+        });
+    }
+    /**
+     * Start the MCP server
+     */
+    async start() {
+        log.info("🎯 Starting NotebookLM MCP Server (Security Hardened)...");
+        log.info("");
+        // Security: Check security context and warn about issues
+        const securityCheck = checkSecurityContext();
+        if (!securityCheck.secure) {
+            log.warning("⚠️  Security warnings detected:");
+            for (const warning of securityCheck.warnings) {
+                log.warning(`    - ${warning}`);
+            }
+            log.info("");
+        }
+        // Security: Initialize MCP authentication
+        const mcpAuth = getMCPAuthenticator();
+        await mcpAuth.initialize();
+        const authStatus = mcpAuth.getStatus();
+        // Audit: Log server startup
+        await audit.system("server_start", {
+            version: "1.2.0-secure.1",
+            security_warnings: securityCheck.warnings,
+            mcp_auth_enabled: authStatus.enabled,
+            config: {
+                headless: CONFIG.headless,
+                max_sessions: CONFIG.maxSessions,
+                session_timeout: CONFIG.sessionTimeout,
+                stealth_enabled: CONFIG.stealthEnabled,
+            },
+        });
+        log.info("📝 Configuration:");
+        log.info(`  Config Dir: ${CONFIG.configDir}`);
+        log.info(`  Data Dir: ${CONFIG.dataDir}`);
+        log.info(`  Headless: ${CONFIG.headless}`);
+        log.info(`  Max Sessions: ${CONFIG.maxSessions}`);
+        log.info(`  Session Timeout: ${CONFIG.sessionTimeout}s`);
+        log.info(`  Stealth: ${CONFIG.stealthEnabled}`);
+        log.info(`  Audit Logging: ${getAuditLogger().getStats().totalEvents >= 0 ? 'enabled' : 'disabled'}`);
+        log.info(`  MCP Authentication: ${authStatus.enabled ? 'enabled' : 'disabled'}`);
+        log.info("");
+        // Create stdio transport
+        const transport = new StdioServerTransport();
+        // Connect server to transport
+        await this.server.connect(transport);
+        log.success("✅ MCP Server connected via stdio");
+        log.success("🎉 Ready to receive requests from Claude Code!");
+        log.info("");
+        log.info("💡 Available tools:");
+        for (const tool of this.toolDefinitions) {
+            const desc = tool.description ? tool.description.split('\n')[0] : 'No description'; // First line only
+            log.info(`  - ${tool.name}: ${desc.substring(0, 80)}...`);
+        }
+        log.info("");
+        log.info("📖 For documentation, see: README.md");
+        log.info("📖 For MCP details, see: MCP_INFOS.md");
+        log.info("");
+    }
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    // Handle CLI commands
+    const args = process.argv.slice(2);
+    if (args.length > 0 && args[0] === "config") {
+        const cli = new CliHandler();
+        await cli.handleCommand(args);
+        process.exit(0);
+    }
+    // Print banner
+    console.error("╔══════════════════════════════════════════════════════════╗");
+    console.error("║                                                          ║");
+    console.error("║           NotebookLM MCP Server v1.0.0                   ║");
+    console.error("║                                                          ║");
+    console.error("║   Chat with Gemini 2.5 through NotebookLM via MCP       ║");
+    console.error("║                                                          ║");
+    console.error("╚══════════════════════════════════════════════════════════╝");
+    console.error("");
+    try {
+        const server = new NotebookLMMCPServer();
+        await server.start();
+    }
+    catch (error) {
+        log.error(`💥 Fatal error starting server: ${error}`);
+        if (error instanceof Error) {
+            log.error(error.stack || "");
+        }
+        process.exit(1);
+    }
+}
+// Run the server
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/library/notebook-library.d.ts

@@ -0,0 +1,70 @@
+/**
+ * NotebookLM Library Manager
+ *
+ * Manages a persistent library of NotebookLM notebooks.
+ * Allows Claude to autonomously add, remove, and switch between
+ * multiple notebooks based on the task at hand.
+ */
+import type { NotebookEntry, AddNotebookInput, UpdateNotebookInput, LibraryStats } from "./types.js";
+export declare class NotebookLibrary {
+    private libraryPath;
+    private library;
+    constructor();
+    /**
+     * Load library from disk, or create default if not exists
+     */
+    private loadLibrary;
+    /**
+     * Create default library from current CONFIG
+     */
+    private createDefaultLibrary;
+    /**
+     * Save library to disk
+     */
+    private saveLibrary;
+    /**
+     * Generate a unique ID from a string (slug format)
+     */
+    private generateId;
+    /**
+     * Add a new notebook to the library
+     */
+    addNotebook(input: AddNotebookInput): NotebookEntry;
+    /**
+     * List all notebooks in library
+     */
+    listNotebooks(): NotebookEntry[];
+    /**
+     * Get a specific notebook by ID
+     */
+    getNotebook(id: string): NotebookEntry | null;
+    /**
+     * Get the currently active notebook
+     */
+    getActiveNotebook(): NotebookEntry | null;
+    /**
+     * Select a notebook as active
+     */
+    selectNotebook(id: string): NotebookEntry;
+    /**
+     * Update notebook metadata
+     */
+    updateNotebook(input: UpdateNotebookInput): NotebookEntry;
+    /**
+     * Remove notebook from library
+     */
+    removeNotebook(id: string): boolean;
+    /**
+     * Increment use count for a notebook
+     */
+    incrementUseCount(id: string): NotebookEntry | null;
+    /**
+     * Get library statistics
+     */
+    getStats(): LibraryStats;
+    /**
+     * Search notebooks by query (searches name, description, topics)
+     */
+    searchNotebooks(query: string): NotebookEntry[];
+}
+//# sourceMappingURL=notebook-library.d.ts.map

package/dist/library/notebook-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notebook-library.d.ts","sourceRoot":"","sources":["../../src/library/notebook-library.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EACV,aAAa,EAEb,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAU;;IAczB;;OAEG;IACH,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAoC5B;;OAEG;IACH,OAAO,CAAC,WAAW;IAanB;;OAEG;IACH,OAAO,CAAC,UAAU;IAkBlB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa;IAuCnD;;OAEG;IACH,aAAa,IAAI,aAAa,EAAE;IAIhC;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI7C;;OAEG;IACH,iBAAiB,IAAI,aAAa,GAAG,IAAI;IAOzC;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAwBzC;;OAEG;IACH,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,aAAa;IA4BzD;;OAEG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAuBnC;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAoBnD;;OAEG;IACH,QAAQ,IAAI,YAAY;IAmBxB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE;CAUhD"}