@roomi-fields/notebooklm-mcp 1.1.4 → 1.2.0

package/README.md

@@ -144,9 +144,18 @@ npm run build
 npm run setup-auth
 # Chrome opens → log in with Google → close Chrome
 
-# 3. Add your first notebook
+# 3. Start the server
+
+# Option A: Foreground mode (terminal stays open)
 npm run start:http
-# In another terminal:
+
+# Option B: Background daemon mode (recommended for production)
+npm run daemon:start    # Start in background
+npm run daemon:logs     # View logs
+npm run daemon:status   # Check status
+npm run daemon:stop     # Stop server
+
+# 4. Add your first notebook (in another terminal if using Option A)
 curl -X POST http://localhost:3000/notebooks \
   -H "Content-Type: application/json" \
   -d '{
@@ -156,12 +165,12 @@ curl -X POST http://localhost:3000/notebooks \
     "topics": ["docs", "api"]
   }'
 
-# 4. Query NotebookLM
+# 5. Query NotebookLM
 curl -X POST http://localhost:3000/ask \
   -H "Content-Type: application/json" \
   -d '{"question": "Explain X"}'
 
-# 5. Validate installation (optional)
+# 6. Validate installation (optional)
 .\deployment\scripts\test-server.ps1
 ```
 
@@ -208,6 +217,39 @@ Perfect for n8n workflows:
 
 **👉 n8n guide:** [deployment/docs/04-N8N-INTEGRATION.md](./deployment/docs/04-N8N-INTEGRATION.md)
 
+### Background Daemon Mode
+
+Run the HTTP server as a background process without keeping a terminal window open:
+
+```bash
+# Start server in background
+npm run daemon:start
+
+# View real-time logs
+npm run daemon:logs
+
+# Check server status
+npm run daemon:status
+
+# Restart server
+npm run daemon:restart
+
+# Stop server
+npm run daemon:stop
+
+# Remove from PM2 process list
+npm run daemon:delete
+```
+
+**Features:**
+- ✅ Runs in background without terminal window
+- ✅ Auto-restart on crash
+- ✅ Centralized log management (logs/pm2-*.log)
+- ✅ Memory limit protection (1GB max)
+- ✅ Production-ready process management
+
+**Configuration:** Edit `ecosystem.config.cjs` to customize PM2 behavior (env vars, restart policy, etc.)
+
 ### Installation & Documentation
 
 - 📖 [**Installation Guide**](./deployment/docs/01-INSTALL.md) — Step-by-step setup
@@ -325,18 +367,39 @@ Share: **⚙️ Share → Anyone with link → Copy**
 
 ---
 
-## Alternative: Claude Code Skill
+## Related Project: Claude Code Skill (by original author)
+
+The original author [PleasePrompto](https://github.com/PleasePrompto) also created a **Python-based Claude Code Skill** as an alternative approach:
+
+🔗 **[NotebookLM Claude Code Skill](https://github.com/PleasePrompto/notebooklm-skill)** - Python skill for Claude Code
+
+### When to use which approach?
+
+| Feature | This Project (MCP + HTTP) | Original Skill (Python) |
+|---------|---------------------------|-------------------------|
+| **Protocol** | MCP (Model Context Protocol) | Claude Skills |
+| **Installation** | `claude mcp add notebooklm npx @roomi-fields/notebooklm-mcp` | Clone to `~/.claude/skills/` |
+| **Sessions** | ✅ Persistent browser sessions | Fresh browser per query |
+| **Compatibility** | ✅ Claude Code, Cursor, Codex, any MCP client | Claude Code only |
+| **HTTP API** | ✅ Works with n8n, Zapier, Make.com | ❌ Not available |
+| **Language** | TypeScript | Python |
+| **Use case** | Long conversations, automation workflows | Quick one-off queries |
 
-**Prefer Claude Code Skills over MCP?** This server is now also available as a native Claude Code Skill with a simpler setup:
+### Which one should you choose?
 
-**NotebookLM Claude Code Skill** - Available separately for advanced Claude Code workflows
+- **Use this MCP project** if you want:
+  - Persistent sessions (faster repeated queries)
+  - Compatibility with multiple tools (Cursor, Codex, etc.)
+  - HTTP REST API for n8n/Zapier automation
+  - TypeScript-based development
 
-**Key differences:**
-- **MCP Server** (this repo): Persistent sessions, works with Claude Code, Codex, Cursor, and other MCP clients
-- **HTTP REST API** (this repo): Works with n8n, Zapier, Make.com, any HTTP client
-- **Claude Code Skill**: Simpler setup, Python-based, stateless queries, works only with local Claude Code
+- **Use the original Skill** if you prefer:
+  - Python-based workflow
+  - Simpler clone-and-use installation
+  - Stateless queries (no session management)
+  - Only using Claude Code locally
 
-All use the same browser automation technology and provide zero-hallucination answers from your NotebookLM notebooks.
+Both use the same Patchright browser automation technology and provide zero-hallucination answers from NotebookLM.
 
 ---
 

package/dist/http-wrapper.js

@@ -182,7 +182,7 @@ app.delete('/sessions/:id', async (req, res) => {
 const PORT = Number(process.env.HTTP_PORT) || 3000;
 const HOST = process.env.HTTP_HOST || '0.0.0.0';
 app.listen(PORT, HOST, () => {
-    log.success(`🌐 NotebookLM MCP HTTP Server v1.1.4`);
+    log.success(`🌐 NotebookLM MCP HTTP Server v1.2.0`);
     log.success(`   Listening on ${HOST}:${PORT}`);
     log.info('');
     log.info('📊 Quick Links:');

package/dist/index.js

@@ -51,7 +51,7 @@ class NotebookLMMCPServer {
         // Initialize MCP Server
         this.server = new Server({
             name: "notebooklm-mcp",
-            version: "1.1.4",
+            version: "1.2.0",
         }, {
             capabilities: {
                 tools: {},
@@ -70,7 +70,7 @@ class NotebookLMMCPServer {
         this.setupHandlers();
         this.setupShutdownHandlers();
         log.info("🚀 NotebookLM MCP Server initialized");
-        log.info(`  Version: 1.1.4`);
+        log.info(`  Version: 1.2.0`);
         log.info(`  Node: ${process.version}`);
         log.info(`  Platform: ${process.platform}`);
     }
@@ -476,7 +476,7 @@ async function main() {
     // Print banner
     console.error("╔══════════════════════════════════════════════════════════╗");
     console.error("║                                                          ║");
-    console.error("║           NotebookLM MCP Server v1.1.4                   ║");
+    console.error("║           NotebookLM MCP Server v1.2.0                   ║");
     console.error("║                                                          ║");
     console.error("║   Chat with Gemini 2.5 through NotebookLM via MCP       ║");
     console.error("║                                                          ║");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomi-fields/notebooklm-mcp",
-  "version": "1.1.4",
+  "version": "1.2.0",
   "description": "MCP server for NotebookLM API with HTTP REST API - Zero hallucinations from your notebooks",
   "type": "module",
   "bin": {
@@ -12,6 +12,12 @@
     "dev": "tsx watch src/index.ts",
     "dev:http": "tsx watch src/http-wrapper.ts",
     "start:http": "node dist/http-wrapper.js",
+    "daemon:start": "pm2 start ecosystem.config.cjs",
+    "daemon:stop": "pm2 stop notebooklm-http",
+    "daemon:restart": "pm2 restart notebooklm-http",
+    "daemon:logs": "pm2 logs notebooklm-http",
+    "daemon:status": "pm2 status",
+    "daemon:delete": "pm2 delete notebooklm-http",
     "setup-auth": "node dist/index.js",
     "prepare": "npm run build",
     "test": "tsx src/index.ts"
@@ -62,6 +68,7 @@
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
     "@types/node": "^20.11.0",
+    "pm2": "^5.4.2",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3"
   },