@roomi-fields/notebooklm-mcp 1.5.0 → 1.5.1

package/LICENSE

@@ -1,22 +1,22 @@
-MIT License
-
-Copyright (c) 2025 Please Prompto! (Original NotebookLM MCP Server)
-Copyright (c) 2025 Romain Peyrichou - HTTP REST API Wrapper (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Please Prompto! (Original NotebookLM MCP Server)
+Copyright (c) 2025 Romain Peyrichou - HTTP REST API Wrapper (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -126,6 +126,7 @@ curl -X POST http://localhost:3000/ask \
 | [Auto-Discovery](./deployment/docs/07-AUTO-DISCOVERY.md)     | Autonomous metadata generation            |
 | [Multi-Interface](./deployment/docs/09-MULTI-INTERFACE.md)   | Run Claude Desktop + HTTP simultaneously  |
 | [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | Profile locking (solved in v1.3.6+)       |
+| [Adding a Language](./docs/ADDING_A_LANGUAGE.md)             | i18n system for multilingual UI support   |
 
 ---
 
@@ -135,6 +136,7 @@ See [ROADMAP.md](./ROADMAP.md) for planned features and version history.
 
 **Latest releases:**
 
+- **v1.5.1** — Multilingual UI support (FR/EN) with i18n selector system + E2E tests (76 tests)
 - **v1.5.0** — Complete Studio content generation (video, infographic, presentation, data_table) + Notes management + Delete sources
 - **v1.4.0** — Content management (sources, audio, generation) + Multi-account
 - **v1.3.7** — Source citation extraction (5 formats)

package/deployment/INDEX.md

@@ -0,0 +1,292 @@
+# Complete Index - NotebookLM MCP HTTP Deployment Package
+
+> Your navigation guide through the deployment documentation
+
+---
+
+## 📚 Overview
+
+This package contains **everything you need** to deploy NotebookLM MCP in HTTP REST API mode.
+
+**Package contents:**
+
+- ✅ 10 documentation files
+- ✅ 4 automated PowerShell scripts
+- ✅ Step-by-step installation guide
+- ✅ Complete API documentation
+- ✅ n8n integration guide
+- ✅ Auto-discovery feature documentation
+
+---
+
+## 🗂️ Directory Structure
+
+```
+deployment/
+├── README.md                       ← Start here!
+├── QUICK-START.md                  ← For the impatient (5 min)
+├── INDEX.md                        ← This file
+├── LICENSE                         ← MIT License
+├── CONTRIBUTING.md                 ← Contribution guide
+├── CHANGELOG.md                    ← Version history
+├── CREDITS.md                      ← Credits and acknowledgments
+├── PACKAGE-FILES.txt               ← List of files to copy
+│
+├── docs/
+│   ├── 01-INSTALL.md              ← Detailed installation guide
+│   ├── 02-CONFIGURATION.md        ← Advanced configuration
+│   ├── 03-API.md                  ← API documentation
+│   ├── 04-N8N-INTEGRATION.md      ← n8n integration
+│   ├── 05-TROUBLESHOOTING.md      ← Problem resolution
+│   ├── 06-NOTEBOOK-LIBRARY.md     ← Multi-notebook management
+│   └── 07-AUTO-DISCOVERY.md       ← Auto-discovery pattern
+│
+└── scripts/
+    ├── install.ps1                ← Automatic installation
+    ├── start-server.ps1           ← Server startup
+    ├── stop-server.ps1            ← Server shutdown
+    └── test-server.ps1            ← Validation tests
+```
+
+---
+
+## 🎯 Where to Start?
+
+### I'm in a HURRY (5 minutes)
+
+→ **[QUICK-START.md](./QUICK-START.md)**
+Installation and testing in 5 quick steps
+
+### I want a COMPLETE installation
+
+→ **[README.md](./README.md)** then **[docs/01-INSTALL.md](./docs/01-INSTALL.md)**
+Detailed guide with explanations
+
+### I want to AUTOMATE the installation
+
+→ **[scripts/install.ps1](./scripts/install.ps1)**
+PowerShell script that does everything
+
+---
+
+## 📖 Available Documentation
+
+### 📄 Main Guides
+
+| File                                         | Description                  | Reading time |
+| -------------------------------------------- | ---------------------------- | ------------ |
+| **[README.md](./README.md)**                 | Package overview             | 5 min        |
+| **[QUICK-START.md](./QUICK-START.md)**       | Quick start in 5 steps       | 2 min        |
+| **[INDEX.md](./INDEX.md)**                   | This file - navigation guide | 3 min        |
+| **[PACKAGE-FILES.txt](./PACKAGE-FILES.txt)** | List of required files       | 2 min        |
+
+### 📚 Detailed Documentation (docs/)
+
+| File                                                        | Description                                 | Reading time |
+| ----------------------------------------------------------- | ------------------------------------------- | ------------ |
+| **[01-INSTALL.md](./docs/01-INSTALL.md)**                   | Complete installation from scratch          | 15 min       |
+| **[02-CONFIGURATION.md](./docs/02-CONFIGURATION.md)**       | Advanced configuration, variables, security | 12 min       |
+| **[03-API.md](./docs/03-API.md)**                           | Complete REST API documentation             | 15 min       |
+| **[04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)**   | Integration with n8n, workflows             | 20 min       |
+| **[05-TROUBLESHOOTING.md](./docs/05-TROUBLESHOOTING.md)**   | Complete problem resolution                 | 15 min       |
+| **[06-NOTEBOOK-LIBRARY.md](./docs/06-NOTEBOOK-LIBRARY.md)** | Multi-notebook library management           | 12 min       |
+| **[07-AUTO-DISCOVERY.md](./docs/07-AUTO-DISCOVERY.md)**     | Autonomous resource discovery pattern       | 15 min       |
+
+### 🤝 Contribution and Project
+
+| File                                     | Description                       | Reading time |
+| ---------------------------------------- | --------------------------------- | ------------ |
+| **[LICENSE](./LICENSE)**                 | MIT License with attributions     | 3 min        |
+| **[CONTRIBUTING.md](./CONTRIBUTING.md)** | Detailed contribution guide       | 10 min       |
+| **[CHANGELOG.md](./CHANGELOG.md)**       | Complete version history          | 8 min        |
+| **[CREDITS.md](./CREDITS.md)**           | Credits, technologies, philosophy | 8 min        |
+
+### 🔧 PowerShell Scripts (scripts/)
+
+| Script                                             | Description                     | Usage                        |
+| -------------------------------------------------- | ------------------------------- | ---------------------------- |
+| **[install.ps1](./scripts/install.ps1)**           | Complete automatic installation | `.\scripts\install.ps1`      |
+| **[start-server.ps1](./scripts/start-server.ps1)** | HTTP server startup             | `.\scripts\start-server.ps1` |
+| **[stop-server.ps1](./scripts/stop-server.ps1)**   | Clean server shutdown           | `.\scripts\stop-server.ps1`  |
+| **[test-server.ps1](./scripts/test-server.ps1)**   | Validation tests                | `.\scripts\test-server.ps1`  |
+
+---
+
+## 🚀 Recommended Workflow
+
+### 1️⃣ Initial Installation
+
+```powershell
+# 1. Read the overview
+cat deployment\README.md
+
+# 2. Run automatic installation
+cd deployment
+.\scripts\install.ps1
+
+# 3. Configure authentication (one time only)
+npm run setup-auth
+```
+
+### 2️⃣ Daily Usage
+
+```powershell
+# Start the server
+cd deployment
+.\scripts\start-server.ps1
+
+# In another terminal: test
+.\scripts\test-server.ps1
+
+# Stop the server
+.\scripts\stop-server.ps1
+```
+
+### 3️⃣ Integration with n8n
+
+1. Read: **[04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)** (TODO)
+2. Configure the HTTP Request node in n8n
+3. Test from n8n
+
+---
+
+## 🎓 Usage Scenarios
+
+### Scenario 1: First Deployment
+
+```
+1. README.md → Overview
+2. 01-INSTALL.md → Detailed installation
+3. scripts/install.ps1 → Automation
+4. scripts/test-server.ps1 → Validation
+```
+
+### Scenario 2: Quick Deployment (Already familiar with Node.js)
+
+```
+1. QUICK-START.md → 5 quick steps
+2. scripts/install.ps1 → Installation
+3. npm run setup-auth → Auth
+4. scripts/start-server.ps1 → Startup
+```
+
+### Scenario 3: n8n Integration
+
+```
+1. 01-INSTALL.md → Server installation
+2. 04-N8N-INTEGRATION.md → n8n configuration
+3. scripts/test-server.ps1 → Tests
+4. n8n Workflow → Production
+```
+
+### Scenario 4: Troubleshooting
+
+```
+1. 05-TROUBLESHOOTING.md → Common solutions
+2. Server logs → Diagnostics
+3. scripts/test-server.ps1 → Validation
+4. GitHub Issues → Community support
+```
+
+---
+
+## 📊 Progress Status
+
+| Document               | Status      | Notes                    |
+| ---------------------- | ----------- | ------------------------ |
+| README.md              | ✅ Complete | Overview updated         |
+| QUICK-START.md         | ✅ Complete | 5 min quick guide        |
+| INDEX.md               | ✅ Complete | This file - navigation   |
+| PACKAGE-FILES.txt      | ✅ Complete | File list                |
+| LICENSE                | ✅ Complete | MIT with attributions    |
+| CONTRIBUTING.md        | ✅ Complete | Contribution guide       |
+| CHANGELOG.md           | ✅ Complete | Version 1.1.2-http       |
+| CREDITS.md             | ✅ Complete | Complete credits         |
+| 01-INSTALL.md          | ✅ Complete | Detailed installation    |
+| 02-CONFIGURATION.md    | ✅ Complete | Variables, security, PM2 |
+| 03-API.md              | ✅ Complete | 12 documented endpoints  |
+| 04-N8N-INTEGRATION.md  | ✅ Complete | 3 example workflows      |
+| 05-TROUBLESHOOTING.md  | ✅ Complete | Complete solutions       |
+| 06-NOTEBOOK-LIBRARY.md | ✅ Complete | Multi-notebook library   |
+| 07-AUTO-DISCOVERY.md   | ✅ Complete | Auto-discovery pattern   |
+| install.ps1            | ✅ Complete | Automatic installation   |
+| start-server.ps1       | ✅ Complete | Startup with checks      |
+| stop-server.ps1        | ✅ Complete | Clean shutdown           |
+| test-server.ps1        | ✅ Complete | Validation tests         |
+
+**Overall status:** ✅ 100% Complete - Ready for Git publication
+
+---
+
+## 🆘 Need Help?
+
+### Quick Support
+
+1. **Installation problem?** → [01-INSTALL.md](./docs/01-INSTALL.md)
+2. **Startup error?** → [05-TROUBLESHOOTING.md](./docs/05-TROUBLESHOOTING.md)
+3. **API question?** → [03-API.md](./docs/03-API.md)
+4. **n8n integration?** → [04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)
+
+### Community Support
+
+- **GitHub Issues:** [To be configured upon repository publication]
+- **Discussions:** [To be configured upon repository publication]
+
+---
+
+## 📝 Release Notes
+
+**Current version:** 1.3.1
+
+**Included in this version:**
+
+- ✅ MCP Auto-Discovery Tool: `auto_discover_notebook` for Claude Desktop
+- ✅ Critical fix: Claude Desktop compatibility (disabled CompleteRequestSchema)
+- ✅ HTTP Auto-Discovery: POST `/notebooks/auto-discover` endpoint
+- ✅ Progressive disclosure inspired by Claude Skills
+- ✅ Automatic metadata validation and generation
+- ✅ Orchestrators can discover documentation autonomously
+- ✅ Fix persistent authentication Windows
+- ✅ Fix NotebookLM streaming detection
+- ✅ Removal of "EXTREMELY IMPORTANT" system phrase
+- ✅ Server listens on 0.0.0.0 (network accessible)
+- ✅ PowerShell automation scripts
+- ✅ Complete deployment documentation
+- ✅ Chrome profile limitation documented
+
+**Possible future improvements (1.4.0+):**
+
+- 🔥 Separate Chrome profiles by mode (HTTP vs stdio) - HIGH PRIORITY
+- ⏳ Smart metadata refresh endpoint
+- ⏳ Semantic matching with embeddings
+- ⏳ Usage analytics for notebooks
+- ⏳ Optional Docker support
+- ⏳ Web administration interface
+- ⏳ Automated tests (unit + integration)
+- ⏳ JWT/OAuth authentication support
+
+---
+
+## 📄 License
+
+**MIT License** - See [LICENSE](./LICENSE) for complete details.
+
+- Original project © 2025 Please Prompto!
+- HTTP Wrapper © 2025 (Developed with Claude Code - Anthropic Claude Sonnet 4.5)
+
+---
+
+## 🤝 Contribution
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for:
+
+- Reporting bugs
+- Proposing improvements
+- Submitting code
+- Standards and Git workflow
+
+---
+
+**Last updated:** January 23, 2025
+**Version:** 1.3.1
+**Status:** ✅ Production-ready - Complete documentation

package/deployment/PACKAGE-FILES.txt

@@ -0,0 +1,180 @@
+# Files Required for NotebookLM MCP HTTP Server Deployment
+# Version: 1.3.0
+
+================================================================================
+FILES TO COPY FROM MAIN PROJECT
+================================================================================
+
+## Root Files
+/package.json
+/package-lock.json
+/tsconfig.json
+/.gitignore
+/LICENSE               → MIT License (original project + HTTP wrapper)
+/README.md             → Project overview
+/CHANGELOG.md          → Version history
+/CONTRIBUTING.md       → Contribution guide
+/CREDITS.md            → Credits and acknowledgments
+
+## Source Code (src/)
+/src/**/*
+
+src/ content details:
+- /src/auth/          → Google authentication management
+- /src/config.ts      → Central configuration
+- /src/errors.ts      → Custom error classes
+- /src/http-wrapper.ts → HTTP entry point (ESSENTIAL!)
+- /src/index.ts       → MCP stdio entry point
+- /src/library/       → Notebook management
+- /src/session/       → Browser session management
+- /src/tools/         → MCP handlers
+- /src/types.ts       → TypeScript definitions
+- /src/utils/         → Utilities (logger, cleanup, etc.)
+
+## HTTP Deployment Documentation (deployment/)
+/deployment/README.md           → HTTP deployment guide
+/deployment/QUICK-START.md      → Quick start (5 min)
+/deployment/INDEX.md            → Navigation index
+/deployment/PACKAGE-FILES.txt   → This file
+/deployment/docs/01-INSTALL.md
+/deployment/docs/02-CONFIGURATION.md
+/deployment/docs/03-API.md
+/deployment/docs/04-N8N-INTEGRATION.md
+/deployment/docs/05-TROUBLESHOOTING.md
+/deployment/docs/06-NOTEBOOK-LIBRARY.md
+/deployment/docs/07-AUTO-DISCOVERY.md
+/deployment/scripts/install.ps1
+/deployment/scripts/start-server.ps1
+/deployment/scripts/stop-server.ps1
+/deployment/scripts/test-server.ps1
+
+================================================================================
+FILES GENERATED AFTER INSTALLATION (DO NOT COPY)
+================================================================================
+
+These files will be created automatically by npm install and npm run build:
+
+/node_modules/        → npm dependencies (DO NOT copy)
+/dist/                → Compiled JavaScript code (generated by npm run build)
+/Data/                → Persistent data (generated by setup-auth)
+
+================================================================================
+COMPLETE STRUCTURE AFTER DEPLOYMENT
+================================================================================
+
+D:\notebooklm-http\
+├── package.json
+├── package-lock.json
+├── tsconfig.json
+├── .gitignore
+├── LICENSE
+├── README.md
+├── CHANGELOG.md
+├── CONTRIBUTING.md
+├── CREDITS.md
+│
+├── src\
+│   ├── http-wrapper.ts
+│   ├── index.ts
+│   ├── config.ts
+│   ├── errors.ts
+│   ├── types.ts
+│   ├── auth\
+│   ├── library\
+│   ├── session\
+│   ├── tools\
+│   └── utils\
+│
+├── deployment\
+│   ├── README.md
+│   ├── QUICK-START.md
+│   ├── INDEX.md
+│   ├── PACKAGE-FILES.txt
+│   ├── docs\
+│   │   ├── 01-INSTALL.md
+│   │   ├── 02-CONFIGURATION.md
+│   │   ├── 03-API.md
+│   │   ├── 04-N8N-INTEGRATION.md
+│   │   └── 05-TROUBLESHOOTING.md
+│   └── scripts\
+│       ├── install.ps1
+│       ├── start-server.ps1
+│       ├── stop-server.ps1
+│       └── test-server.ps1
+│
+├── node_modules\      (created by npm install)
+├── dist\              (created by npm run build)
+└── Data\              (created by setup-auth)
+    ├── chrome_profile\
+    ├── browser_state\
+    └── library.json
+
+================================================================================
+COMMANDS TO CREATE A DEPLOYABLE PACKAGE
+================================================================================
+
+## Method 1: Manual Copy
+```powershell
+# Create a new folder
+mkdir D:\notebooklm-http-deploy
+
+# Copy required files
+Copy-Item package.json D:\notebooklm-http-deploy\
+Copy-Item package-lock.json D:\notebooklm-http-deploy\
+Copy-Item tsconfig.json D:\notebooklm-http-deploy\
+Copy-Item .gitignore D:\notebooklm-http-deploy\
+Copy-Item -Recurse src D:\notebooklm-http-deploy\
+Copy-Item -Recurse deployment D:\notebooklm-http-deploy\
+
+# Go to the new folder
+cd D:\notebooklm-http-deploy
+
+# Installation
+.\deployment\scripts\install.ps1
+```
+
+## Method 2: ZIP Archive (Recommended for Distribution)
+```powershell
+# Create a clean archive
+$files = @(
+    "package.json",
+    "package-lock.json",
+    "tsconfig.json",
+    ".gitignore",
+    "src",
+    "deployment"
+)
+
+Compress-Archive -Path $files -DestinationPath notebooklm-http-v1.3.0.zip
+```
+
+## Method 3: Git Clone
+```powershell
+git clone <repo-url> D:\notebooklm-http
+cd D:\notebooklm-http
+.\deployment\scripts\install.ps1
+```
+
+================================================================================
+APPROXIMATE SIZE
+================================================================================
+
+Source files + config:     ~2 MB
+node_modules/:             ~150 MB
+dist/:                     ~3 MB
+Data/ (after auth):        ~100 MB
+
+TOTAL after installation:  ~255 MB
+
+================================================================================
+SENSITIVE FILES (NEVER COMMIT)
+================================================================================
+
+/Data/chrome_profile/         → Contains Google cookies
+/Data/browser_state/state.json → Contains Google session
+.env                          → Environment variables (if used)
+node_modules/                 → Dependencies (regenerable)
+
+These files are already in .gitignore
+
+================================================================================

package/deployment/QUICK-START.md

@@ -0,0 +1,100 @@
+# Quick Start Guide - 5 Minutes ⚡
+
+> For busy users already familiar with Node.js and npm
+
+---
+
+## ✅ Prerequisites
+
+- Windows 10/11 (64-bit)
+- Node.js 20+ and npm 10+ installed
+- Google account with NotebookLM access
+
+**Note:** This package is optimized for Windows only.
+
+---
+
+## 🚀 Installation in 5 Steps
+
+### 1. Clone and Install (2 min)
+
+```powershell
+cd D:\
+git clone <repo-url> notebooklm-http
+cd notebooklm-http
+npm install
+npm run build
+```
+
+### 2. Configure Authentication (1 min)
+
+```powershell
+npm run setup-auth
+```
+
+- Chrome opens
+- Log in to Google
+- Go to https://notebooklm.google.com
+- Close Chrome
+- ✅ Auth saved!
+
+### 3. Start the Server (30 sec)
+
+```powershell
+npm run start:http
+```
+
+### 4. Test (30 sec)
+
+New terminal:
+
+```powershell
+curl http://localhost:3000/health
+```
+
+### 5. Use (1 min)
+
+```powershell
+curl -X POST http://localhost:3000/ask `
+  -H "Content-Type: application/json" `
+  -d '{"question":"Test","notebook_id":"your-id"}'
+```
+
+---
+
+## 🎯 n8n Configuration
+
+1. **HTTP Request node** in n8n
+2. **URL:** `http://<PC-IP>:3000/ask`
+3. **Method:** POST
+4. **Body:**
+   ```json
+   {
+     "question": "{{ $json.query }}",
+     "notebook_id": "your-id"
+   }
+   ```
+
+---
+
+## 📖 Complete Documentation
+
+- Detailed installation: [docs/01-INSTALL.md](./docs/01-INSTALL.md)
+- Complete overview: [root README.md](../README.md)
+- API: [docs/03-API.md](./docs/03-API.md)
+- n8n: [docs/04-N8N-INTEGRATION.md](./docs/04-N8N-INTEGRATION.md)
+- Troubleshooting: [docs/05-TROUBLESHOOTING.md](./docs/05-TROUBLESHOOTING.md)
+
+---
+
+## 🐛 Common Issues
+
+| Problem              | Solution                                                      |
+| -------------------- | ------------------------------------------------------------- |
+| Port 3000 occupied   | `netstat -ano \| findstr :3000` then `taskkill /PID <pid> /F` |
+| Session expires      | `npm run setup-auth`                                          |
+| "Target page closed" | Stop all node.exe processes and restart                       |
+
+---
+
+**✅ That's it! You're all set!**