@roomi-fields/notebooklm-mcp 1.5.4 → 1.5.8

package/scripts/doctor.mjs

@@ -0,0 +1,257 @@
+#!/usr/bin/env node
+
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join, resolve } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(__dirname, '..');
+
+function parseArgs(argv) {
+  const args = {
+    mode: 'basic',
+    baseUrl: process.env.NOTEBOOKLM_MCP_BASE_URL || 'http://127.0.0.1:3000',
+    notebookUrl: process.env.NOTEBOOK_URL || '',
+    timeoutMs: 15000,
+    question:
+      'What is the main topic covered by this notebook? Answer in one sentence.',
+  };
+
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    switch (arg) {
+      case '--basic':
+        args.mode = 'basic';
+        break;
+      case '--http':
+        args.mode = 'http';
+        break;
+      case '--base-url':
+        args.baseUrl = argv[++i] || args.baseUrl;
+        break;
+      case '--notebook-url':
+        args.notebookUrl = argv[++i] || '';
+        break;
+      case '--timeout-ms':
+        args.timeoutMs = Number(argv[++i] || args.timeoutMs);
+        break;
+      case '--question':
+        args.question = argv[++i] || args.question;
+        break;
+      case '--help':
+      case '-h':
+        printHelp();
+        process.exit(0);
+      default:
+        if (arg.startsWith('--base-url=')) {
+          args.baseUrl = arg.split('=', 2)[1];
+        } else if (arg.startsWith('--notebook-url=')) {
+          args.notebookUrl = arg.split('=', 2)[1];
+        } else if (arg.startsWith('--timeout-ms=')) {
+          args.timeoutMs = Number(arg.split('=', 2)[1]);
+        } else if (arg.startsWith('--question=')) {
+          args.question = arg.split('=', 2)[1];
+        } else {
+          throw new Error(`Unknown argument: ${arg}`);
+        }
+    }
+  }
+
+  return args;
+}
+
+function printHelp() {
+  console.log(`NotebookLM MCP doctor
+
+Usage:
+  node scripts/doctor.mjs --basic
+  node scripts/doctor.mjs --http
+  node scripts/doctor.mjs --http --notebook-url "https://notebooklm.google.com/notebook/<your-notebook-id>"
+
+Options:
+  --basic               Run repo and build checks only.
+  --http                Also verify the local HTTP server.
+  --base-url <url>      Override HTTP base URL (default: http://127.0.0.1:3000).
+  --notebook-url <url>  Optional NotebookLM URL for /content and /ask checks.
+  --timeout-ms <ms>     Per-request timeout in milliseconds.
+  --question <text>     Custom ask prompt for the /ask verification step.
+`);
+}
+
+function pass(message) {
+  console.log(`[PASS] ${message}`);
+}
+
+function warn(message) {
+  console.log(`[WARN] ${message}`);
+}
+
+function fail(message) {
+  console.error(`[FAIL] ${message}`);
+}
+
+function loadPackageJson() {
+  const packagePath = join(repoRoot, 'package.json');
+  if (!existsSync(packagePath)) {
+    throw new Error(`package.json not found at ${packagePath}`);
+  }
+
+  return JSON.parse(readFileSync(packagePath, 'utf8'));
+}
+
+function getMinNodeMajor(range) {
+  const match = String(range || '').match(/(\d+)/);
+  return match ? Number(match[1]) : 18;
+}
+
+async function fetchJson(url, options = {}, timeoutMs = 15000) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const response = await fetch(url, {
+      ...options,
+      signal: controller.signal,
+      headers: {
+        'Content-Type': 'application/json',
+        ...(options.headers || {}),
+      },
+    });
+
+    const text = await response.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : {};
+    } catch {
+      data = { raw: text };
+    }
+
+    return { ok: response.ok, status: response.status, data };
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  let hasFailure = false;
+
+  const packageJson = loadPackageJson();
+  const requiredNode = getMinNodeMajor(packageJson.engines?.node);
+  const currentNode = Number(process.versions.node.split('.')[0]);
+
+  if (currentNode < requiredNode) {
+    fail(`Node.js ${process.versions.node} is too old. Required: >=${requiredNode}`);
+    hasFailure = true;
+  } else {
+    pass(`Node.js ${process.versions.node} satisfies engines.node (${packageJson.engines?.node})`);
+  }
+
+  const requiredPaths = [
+    ['package.json', join(repoRoot, 'package.json')],
+    ['README.md', join(repoRoot, 'README.md')],
+    ['dist/index.js', join(repoRoot, 'dist', 'index.js')],
+    ['dist/http-wrapper.js', join(repoRoot, 'dist', 'http-wrapper.js')],
+  ];
+
+  for (const [label, filePath] of requiredPaths) {
+    if (existsSync(filePath)) {
+      pass(`Found ${label}`);
+    } else {
+      fail(`Missing ${label} at ${filePath}`);
+      hasFailure = true;
+    }
+  }
+
+  if (args.mode !== 'http') {
+    if (hasFailure) {
+      process.exit(1);
+    }
+    pass('Basic verification completed.');
+    return;
+  }
+
+  const health = await fetchJson(`${args.baseUrl}/health`, {}, args.timeoutMs).catch((error) => {
+    fail(`Could not reach ${args.baseUrl}/health: ${error.message}`);
+    hasFailure = true;
+    return null;
+  });
+
+  if (!health) {
+    process.exit(1);
+  }
+
+  if (!health.ok || !health.data?.success) {
+    fail(`/health failed with status ${health.status}`);
+    hasFailure = true;
+  } else {
+    pass(`/health succeeded (authenticated=${health.data?.data?.authenticated === true})`);
+  }
+
+  if (!args.notebookUrl) {
+    warn('No notebook URL provided. Skipping /content and /ask checks.');
+    process.exit(hasFailure ? 1 : 0);
+  }
+
+  const encodedNotebookUrl = encodeURIComponent(args.notebookUrl);
+  const content = await fetchJson(
+    `${args.baseUrl}/content?notebook_url=${encodedNotebookUrl}`,
+    {},
+    Math.max(args.timeoutMs, 30000)
+  ).catch((error) => {
+    fail(`/content request failed: ${error.message}`);
+    hasFailure = true;
+    return null;
+  });
+
+  if (content) {
+    if (!content.ok || !content.data?.success) {
+      fail(`/content failed with status ${content.status}`);
+      hasFailure = true;
+    } else {
+      const sourceCount = content.data?.data?.sourceCount;
+      pass(`/content succeeded${typeof sourceCount === 'number' ? ` (sourceCount=${sourceCount})` : ''}`);
+    }
+  }
+
+  const askPayload = {
+    question: args.question,
+    notebook_url: args.notebookUrl,
+    session_id: `doctor-${Date.now()}`,
+    source_format: 'none',
+  };
+
+  const ask = await fetchJson(
+    `${args.baseUrl}/ask`,
+    {
+      method: 'POST',
+      body: JSON.stringify(askPayload),
+    },
+    Math.max(args.timeoutMs, 120000)
+  ).catch((error) => {
+    fail(`/ask request failed: ${error.message}`);
+    hasFailure = true;
+    return null;
+  });
+
+  if (ask) {
+    if (!ask.ok || !ask.data?.success) {
+      fail(`/ask failed with status ${ask.status}`);
+      hasFailure = true;
+    } else {
+      const answer = ask.data?.data?.answer || '';
+      pass(`/ask succeeded (${answer.length} chars returned)`);
+    }
+  }
+
+  if (hasFailure) {
+    process.exit(1);
+  }
+
+  pass('HTTP verification completed.');
+}
+
+main().catch((error) => {
+  fail(error.message);
+  process.exit(1);
+});

package/scripts/mcp-proxy-hidden.ps1

@@ -0,0 +1,31 @@
+# MCP Proxy Launcher - Hidden Window
+# Lance le stdio-http-proxy sans fenêtre visible
+
+$scriptPath = Split-Path -Parent $PSScriptRoot
+$proxyPath = Join-Path $scriptPath "dist\stdio-http-proxy.js"
+
+$env:NBLM_HOST = "localhost"
+$env:NBLM_PORT = "3000"
+
+# Lance node avec la fenêtre cachée
+$psi = New-Object System.Diagnostics.ProcessStartInfo
+$psi.FileName = "node"
+$psi.Arguments = $proxyPath
+$psi.WorkingDirectory = $scriptPath
+$psi.UseShellExecute = $false
+$psi.RedirectStandardInput = $true
+$psi.RedirectStandardOutput = $true
+$psi.RedirectStandardError = $true
+$psi.CreateNoWindow = $true
+
+$process = [System.Diagnostics.Process]::Start($psi)
+
+# Relay stdin/stdout pour le protocole MCP
+$inputTask = [System.Threading.Tasks.Task]::Run({
+    param($proc)
+    try {
+        [Console]::OpenStandardInput().CopyTo($proc.StandardInput.BaseStream)
+    } catch {}
+}, $process)
+
+$process.StandardOutput.BaseStream.CopyTo([Console]::OpenStandardOutput())

package/scripts/mcp-wsl-helper.sh

@@ -13,7 +13,7 @@
 set -e
 
 MCP_PORT=3000
-MCP_DIR="D:/Claude/notebooklm-mcp-http"
+MCP_DIR="D:/path/to/notebooklm-mcp"
 
 # Helper function to call the API via PowerShell (bypasses WSL network issues)
 call_api() {

package/scripts/start-server-hidden.vbs

@@ -0,0 +1,16 @@
+' NotebookLM MCP Server - hidden startup helper
+' Starts the HTTP server without opening a visible console window.
+
+Dim fso
+Dim shell
+Dim scriptDir
+Dim projectDir
+
+Set fso = CreateObject("Scripting.FileSystemObject")
+Set shell = CreateObject("WScript.Shell")
+
+scriptDir = fso.GetParentFolderName(WScript.ScriptFullName)
+projectDir = fso.GetParentFolderName(scriptDir)
+
+shell.CurrentDirectory = projectDir
+shell.Run "node dist/http-wrapper.js", 0, False

package/scripts/start-server.ps1

@@ -11,7 +11,7 @@
 
 .EXAMPLE
     # Run in background (hidden window)
-    Start-Process powershell -ArgumentList "-ExecutionPolicy Bypass -File D:\Claude\notebooklm-mcp-http\scripts\start-server.ps1" -WindowStyle Hidden
+    Start-Process powershell -ArgumentList "-ExecutionPolicy Bypass -File D:\path\to\notebooklm-mcp\scripts\start-server.ps1" -WindowStyle Hidden
 #>
 
 param(

package/scripts/stop-server.bat

@@ -0,0 +1,5 @@
+@echo off
+REM Arrête le serveur NotebookLM MCP
+taskkill /F /FI "WINDOWTITLE eq node*http-wrapper*" 2>nul
+taskkill /F /FI "IMAGENAME eq node.exe" /FI "MEMUSAGE gt 100000" 2>nul
+echo Serveur arrêté.

package/scripts/switch-account-language.sh

@@ -1,191 +1,150 @@
 #!/bin/bash
 # Switch Account Language Script
 #
-# This script automates the process of switching an account to a new language.
-# It deletes the Chrome profile cache and re-authenticates to get a fresh profile
-# with the new language settings from Google Account.
-#
-# PREREQUISITE: You must first change the language in Google Account settings:
-# https://myaccount.google.com/language
-#
-# Usage:
-#   ./switch-account-language.sh --account=rom1pey --lang=en
-#   ./switch-account-language.sh --account=mathieu --lang=fr
-#   ./switch-account-language.sh --account=rpmonster --lang=en --show
+# Refreshes one account profile after the user changes the Google Account
+# language. This script is intentionally generic: you provide the account ID,
+# repo root, and optionally the NotebookLM data directory.
 
-set -e
+set -euo pipefail
 
-# Default values
-ACCOUNT=""
+ACCOUNT_ID=""
 LANG=""
 SHOW_BROWSER=""
+REPO_ROOT=""
+DATA_PATH="${NOTEBOOKLM_DATA_PATH:-}"
+
+usage() {
+  echo "Switch Account Language Script"
+  echo ""
+  echo "Prerequisite:"
+  echo "  Change the Google Account language first:"
+  echo "  https://myaccount.google.com/language"
+  echo ""
+  echo "Usage:"
+  echo "  ./scripts/switch-account-language.sh --account-id=account-0000000000001 --lang=en --repo-root=/absolute/path/to/notebooklm-mcp"
+  echo ""
+  echo "Options:"
+  echo "  --account-id=ID   Account directory ID under Data/accounts/ (required)"
+  echo "  --lang=LANG       Target UI locale: en|fr (required)"
+  echo "  --repo-root=PATH  Repo root containing package.json (required unless run there)"
+  echo "  --data-path=PATH  NotebookLM data directory override"
+  echo "  --show            Show browser during re-authentication"
+  echo "  --help            Show this help"
+}
 
-# Account configurations
-declare -A ACCOUNT_IDS=(
-  ["mathieu"]="account-1766565732376"
-  ["rpmonster"]="account-1767078713573"
-  ["rom1pey"]="account-1767079146601"
-)
-
-declare -A ACCOUNT_EMAILS=(
-  ["mathieu"]="mathieudumont31@gmail.com"
-  ["rpmonster"]="rpmonster@gmail.com"
-  ["rom1pey"]="rom1pey@gmail.com"
-)
-
-# Data path
-DATA_PATH="/mnt/c/Users/romai/AppData/Local/notebooklm-mcp/Data"
-
-# Parse arguments
 for arg in "$@"; do
   case $arg in
-    --account=*)
-      ACCOUNT="${arg#*=}"
+    --account-id=*)
+      ACCOUNT_ID="${arg#*=}"
       ;;
     --lang=*)
       LANG="${arg#*=}"
       ;;
+    --repo-root=*)
+      REPO_ROOT="${arg#*=}"
+      ;;
+    --data-path=*)
+      DATA_PATH="${arg#*=}"
+      ;;
     --show)
       SHOW_BROWSER="--show"
       ;;
     --help)
-      echo "Switch Account Language Script"
-      echo ""
-      echo "PREREQUISITE: Change language in Google Account first:"
-      echo "  https://myaccount.google.com/language"
-      echo ""
-      echo "Usage: ./switch-account-language.sh [options]"
-      echo ""
-      echo "Options:"
-      echo "  --account=NAME    Account: mathieu|rpmonster|rom1pey (required)"
-      echo "  --lang=LANG       Target language: en|fr (required)"
-      echo "  --show            Show browser during re-authentication"
-      echo "  --help            Show this help"
-      echo ""
-      echo "Examples:"
-      echo "  ./switch-account-language.sh --account=rom1pey --lang=en"
-      echo "  ./switch-account-language.sh --account=mathieu --lang=fr --show"
+      usage
       exit 0
       ;;
+    *)
+      echo "ERROR: Unknown argument: $arg"
+      usage
+      exit 1
+      ;;
   esac
 done
 
-# Validate arguments
-if [ -z "$ACCOUNT" ]; then
-  echo "ERROR: --account is required"
-  echo "Use --help for usage information"
+if [ -z "$ACCOUNT_ID" ]; then
+  echo "ERROR: --account-id is required"
+  usage
   exit 1
 fi
 
 if [ -z "$LANG" ]; then
   echo "ERROR: --lang is required"
-  echo "Use --help for usage information"
+  usage
   exit 1
 fi
 
-if [ -z "${ACCOUNT_IDS[$ACCOUNT]}" ]; then
-  echo "ERROR: Unknown account '$ACCOUNT'"
-  echo "Valid accounts: mathieu, rpmonster, rom1pey"
+if [ "$LANG" != "en" ] && [ "$LANG" != "fr" ]; then
+  echo "ERROR: --lang must be en or fr"
   exit 1
 fi
 
-if [ "$LANG" != "en" ] && [ "$LANG" != "fr" ]; then
-  echo "ERROR: Invalid language '$LANG'"
-  echo "Valid languages: en, fr"
+if [ -z "$REPO_ROOT" ]; then
+  if [ -f "./package.json" ]; then
+    REPO_ROOT="$(pwd)"
+  else
+    echo "ERROR: --repo-root is required unless you run the script from the repo root"
+    exit 1
+  fi
+fi
+
+if [ ! -f "$REPO_ROOT/package.json" ]; then
+  echo "ERROR: package.json not found in repo root: $REPO_ROOT"
   exit 1
 fi
 
-ACCOUNT_ID="${ACCOUNT_IDS[$ACCOUNT]}"
-ACCOUNT_EMAIL="${ACCOUNT_EMAILS[$ACCOUNT]}"
+if [ -z "$DATA_PATH" ]; then
+  if [ -n "${LOCALAPPDATA:-}" ]; then
+    DATA_PATH="${LOCALAPPDATA}/notebooklm-mcp/Data"
+  else
+    echo "ERROR: data path not set. Use --data-path or NOTEBOOKLM_DATA_PATH."
+    exit 1
+  fi
+fi
 
-echo "╔════════════════════════════════════════════════════════════╗"
-echo "║  Switch Account Language                                    ║"
-echo "╠════════════════════════════════════════════════════════════╣"
-echo "║  Account: $ACCOUNT ($ACCOUNT_EMAIL)"
-echo "║  Target:  $LANG"
-echo "╚════════════════════════════════════════════════════════════╝"
+echo "Switching account language"
+echo "  account-id: $ACCOUNT_ID"
+echo "  locale:     $LANG"
+echo "  repo-root:  $REPO_ROOT"
+echo "  data-path:  $DATA_PATH"
 echo ""
 
-# Step 1: Stop server and Chrome
-echo "Step 1/5: Stopping server and Chrome..."
+echo "Step 1/5: Stopping repo-related Node processes..."
 cmd.exe /c "taskkill /F /IM node.exe" 2>/dev/null || true
 sleep 1
-# Only kill Chrome if profile is locked (don't kill user's personal browser)
-if [ -f "$DATA_PATH/chrome_profile/lockfile" ] 2>/dev/null; then
-  echo "  Chrome profile locked, killing Chrome..."
-  cmd.exe /c "taskkill /F /IM chrome.exe" 2>/dev/null || true
-  sleep 2
-fi
-echo "  Done."
 
-# Step 2: Delete account's Chrome profile (to clear language cache)
-echo ""
-echo "Step 2/5: Deleting Chrome profile cache for $ACCOUNT..."
+echo "Step 2/5: Removing cached profile for the selected account..."
 ACCOUNT_PROFILE="$DATA_PATH/accounts/$ACCOUNT_ID/profile"
 if [ -d "$ACCOUNT_PROFILE" ]; then
   rm -rf "$ACCOUNT_PROFILE"
-  echo "  Deleted: $ACCOUNT_PROFILE"
+  echo "  Removed $ACCOUNT_PROFILE"
 else
-  echo "  Profile not found (already clean)"
+  echo "  No account profile found to remove"
 fi
-echo "  Done."
-
-# Step 3: Re-authenticate to create fresh profile
-echo ""
-echo "Step 3/5: Re-authenticating $ACCOUNT..."
-echo "  This will open a browser to log in with the new language settings."
-echo ""
 
-cd /mnt/d/Claude/notebooklm-mcp-http
-cmd.exe /c "cd /d D:\\Claude\\notebooklm-mcp-http && npm run accounts test $ACCOUNT_ID -- $SHOW_BROWSER"
-
-echo "  Done."
-
-# Step 4: Sync new profile to main
-echo ""
-echo "Step 4/5: Syncing new profile to main..."
+echo "Step 3/5: Re-authenticating the selected account..."
+cmd.exe /c "cd /d $REPO_ROOT && npm run accounts test $ACCOUNT_ID -- $SHOW_BROWSER"
 
-# Sync state.json
+echo "Step 4/5: Syncing the refreshed profile into the active data path..."
 if [ -f "$DATA_PATH/accounts/$ACCOUNT_ID/browser_state/state.json" ]; then
-  cp "$DATA_PATH/accounts/$ACCOUNT_ID/browser_state/state.json" "$DATA_PATH/browser_state/"
-  echo "  Synced state.json"
+  mkdir -p "$DATA_PATH/browser_state"
+  cp "$DATA_PATH/accounts/$ACCOUNT_ID/browser_state/state.json" "$DATA_PATH/browser_state/state.json"
+  echo "  Synced browser_state/state.json"
 else
-  echo "  WARNING: state.json not found"
+  echo "  WARNING: browser_state/state.json not found for $ACCOUNT_ID"
 fi
 
-# Sync Chrome profile
 rm -rf "$DATA_PATH/chrome_profile" 2>/dev/null || true
 if [ -d "$DATA_PATH/accounts/$ACCOUNT_ID/profile" ]; then
   cp -r "$DATA_PATH/accounts/$ACCOUNT_ID/profile" "$DATA_PATH/chrome_profile"
-  echo "  Synced Chrome profile"
+  echo "  Synced chrome_profile/"
 else
-  echo "  WARNING: Chrome profile not found"
+  echo "  WARNING: refreshed profile not found for $ACCOUNT_ID"
 fi
-echo "  Done."
 
-# Step 5: Restart server with correct locale
-echo ""
-echo "Step 5/5: Starting server with UI locale '$LANG'..."
-
-# Convert lang to uppercase for display
-LANG_UPPER=$(echo "$LANG" | tr '[:lower:]' '[:upper:]')
-
-cmd.exe /c "cd /d D:\\Claude\\notebooklm-mcp-http && set NOTEBOOKLM_UI_LOCALE=$LANG&& start /B node dist/http-wrapper.js" &
+echo "Step 5/5: Restarting the HTTP server with the requested locale..."
+cmd.exe /c "cd /d $REPO_ROOT && set NOTEBOOKLM_UI_LOCALE=$LANG&& start /B node dist/http-wrapper.js" >/dev/null
 sleep 4
 
-# Verify
-echo ""
-echo "Verifying server..."
-HEALTH=$(cmd.exe /c "curl -s http://localhost:3000/health" 2>/dev/null || echo '{"error":"failed"}')
-echo "$HEALTH" | head -c 200
-
-echo ""
 echo ""
-echo "╔════════════════════════════════════════════════════════════╗"
-echo "║  COMPLETED                                                  ║"
-echo "╠════════════════════════════════════════════════════════════╣"
-echo "║  Account '$ACCOUNT' is now configured for '$LANG_UPPER'."
-echo "║                                                             ║"
-echo "║  IMPORTANT: Verify visually that NotebookLM UI is in $LANG_UPPER    ║"
-echo "║  by running a test with show_browser:true                   ║"
-echo "╚════════════════════════════════════════════════════════════╝"
+echo "Health check:"
+cmd.exe /c "curl -s http://127.0.0.1:3000/health" || true