@roomi-fields/notebooklm-mcp 1.1.5 → 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

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.5`);
+    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.5",
+            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.5`);
+        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.5                   ║");
+    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.5",
+  "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"
   },