@roomi-fields/notebooklm-mcp 1.5.7 → 1.5.8

package/scripts/docker-entrypoint.sh

@@ -1,25 +1,25 @@
-#!/bin/bash
-# Docker entrypoint for NotebookLM MCP Server
-# Starts VNC services (for visual auth) and Node.js HTTP server
-set -e
-echo "==========================================="
-echo "  NotebookLM MCP Server - Docker"
-echo "==========================================="
-echo ""
-# Check if VNC should be started (default: yes in Docker)
-ENABLE_VNC="${ENABLE_VNC:-true}"
-if [ "$ENABLE_VNC" = "true" ]; then
-    echo "[Entrypoint] Starting VNC services..."
-    source /app/scripts/start-vnc.sh
-    echo ""
-    echo "[Entrypoint] VNC ready at: http://<host>:${NOVNC_PORT:-6080}/vnc.html"
-    echo ""
-else
-    echo "[Entrypoint] VNC disabled (ENABLE_VNC=false)"
-fi
-# Render injecte automatiquement PORT, on l'utilise en priorité
-export HTTP_PORT=${PORT:-${HTTP_PORT:-3000}}
-echo "[Entrypoint] Starting Node.js HTTP server on port ${HTTP_PORT}..."
-echo ""
-# Start the Node.js server (foreground)
-exec node dist/http-wrapper.js
+#!/bin/bash
+# Docker entrypoint for NotebookLM MCP Server
+# Starts VNC services (for visual auth) and Node.js HTTP server
+set -e
+echo "==========================================="
+echo "  NotebookLM MCP Server - Docker"
+echo "==========================================="
+echo ""
+# Check if VNC should be started (default: yes in Docker)
+ENABLE_VNC="${ENABLE_VNC:-true}"
+if [ "$ENABLE_VNC" = "true" ]; then
+    echo "[Entrypoint] Starting VNC services..."
+    source /app/scripts/start-vnc.sh
+    echo ""
+    echo "[Entrypoint] VNC ready at: http://<host>:${NOVNC_PORT:-6080}/vnc.html"
+    echo ""
+else
+    echo "[Entrypoint] VNC disabled (ENABLE_VNC=false)"
+fi
+# Render injecte automatiquement PORT, on l'utilise en priorité
+export HTTP_PORT=${PORT:-${HTTP_PORT:-3000}}
+echo "[Entrypoint] Starting Node.js HTTP server on port ${HTTP_PORT}..."
+echo ""
+# Start the Node.js server (foreground)
+exec node dist/http-wrapper.js

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-wsl-helper.sh

@@ -1,146 +1,146 @@
-#!/bin/bash
-# NotebookLM MCP HTTP Server - WSL Helper Script
-# This script helps interact with the Windows-hosted MCP server from WSL
-#
-# Usage:
-#   ./mcp-wsl-helper.sh start          Start the server (Windows)
-#   ./mcp-wsl-helper.sh stop           Stop the server
-#   ./mcp-wsl-helper.sh status         Check if server is running
-#   ./mcp-wsl-helper.sh health         Get health status
-#   ./mcp-wsl-helper.sh ask "question" Ask a question to the active notebook
-#   ./mcp-wsl-helper.sh auth           Launch authentication (opens Chrome)
-
-set -e
-
-MCP_PORT=3000
-MCP_DIR="D:/Claude/notebooklm-mcp-http"
-
-# Helper function to call the API via PowerShell (bypasses WSL network issues)
-call_api() {
-    local method="$1"
-    local endpoint="$2"
-    local body="$3"
-
-    if [ -n "$body" ]; then
-        powershell.exe -Command "Invoke-RestMethod -Uri 'http://localhost:${MCP_PORT}${endpoint}' -Method ${method} -ContentType 'application/json' -Body '${body}' | ConvertTo-Json -Depth 10" 2>&1
-    else
-        powershell.exe -Command "Invoke-RestMethod -Uri 'http://localhost:${MCP_PORT}${endpoint}' -Method ${method} | ConvertTo-Json -Depth 10" 2>&1
-    fi
-}
-
-# Check if server is running
-is_running() {
-    cmd.exe /c "netstat -ano | findstr :${MCP_PORT} | findstr LISTENING" >/dev/null 2>&1
-}
-
-# Get server PID
-get_pid() {
-    cmd.exe /c "netstat -ano | findstr :${MCP_PORT} | findstr LISTENING" 2>/dev/null | awk '{print $5}' | tr -d '\r'
-}
-
-case "$1" in
-    start)
-        if is_running; then
-            echo "Server already running (PID: $(get_pid))"
-            exit 0
-        fi
-        echo "Starting NotebookLM MCP HTTP Server..."
-        powershell.exe -Command "Start-Process -NoNewWindow -FilePath 'node' -ArgumentList '${MCP_DIR}/dist/http-wrapper.js' -WorkingDirectory '${MCP_DIR}'" 2>&1
-        sleep 3
-        if is_running; then
-            echo "Server started successfully (PID: $(get_pid))"
-            echo "Health: http://localhost:${MCP_PORT}/health"
-        else
-            echo "Failed to start server"
-            exit 1
-        fi
-        ;;
-
-    stop)
-        if ! is_running; then
-            echo "Server not running"
-            exit 0
-        fi
-        PID=$(get_pid)
-        echo "Stopping server (PID: ${PID})..."
-        cmd.exe /c "taskkill /PID ${PID} /F" 2>&1
-        echo "Server stopped"
-        ;;
-
-    status)
-        if is_running; then
-            echo "Server is RUNNING (PID: $(get_pid))"
-            echo ""
-            call_api "GET" "/health"
-        else
-            echo "Server is STOPPED"
-            exit 1
-        fi
-        ;;
-
-    health)
-        if ! is_running; then
-            echo '{"success":false,"error":"Server not running"}'
-            exit 1
-        fi
-        call_api "GET" "/health"
-        ;;
-
-    auth)
-        if ! is_running; then
-            echo "Server not running. Start it first with: $0 start"
-            exit 1
-        fi
-        echo "Launching authentication (Chrome will open)..."
-        call_api "POST" "/setup-auth" '{"show_browser": true}'
-        ;;
-
-    ask)
-        if [ -z "$2" ]; then
-            echo "Usage: $0 ask \"your question here\" [notebook_id]"
-            exit 1
-        fi
-        if ! is_running; then
-            echo '{"success":false,"error":"Server not running"}'
-            exit 1
-        fi
-        QUESTION="$2"
-        NOTEBOOK_ID="${3:-}"
-
-        if [ -n "$NOTEBOOK_ID" ]; then
-            BODY="{\"question\": \"${QUESTION}\", \"notebook_id\": \"${NOTEBOOK_ID}\"}"
-        else
-            BODY="{\"question\": \"${QUESTION}\"}"
-        fi
-
-        call_api "POST" "/ask" "$BODY"
-        ;;
-
-    notebooks)
-        if ! is_running; then
-            echo '{"success":false,"error":"Server not running"}'
-            exit 1
-        fi
-        call_api "GET" "/notebooks"
-        ;;
-
-    *)
-        echo "NotebookLM MCP HTTP Server - WSL Helper"
-        echo ""
-        echo "Usage: $0 <command> [args]"
-        echo ""
-        echo "Commands:"
-        echo "  start              Start the server (Windows background process)"
-        echo "  stop               Stop the server"
-        echo "  status             Check server status and health"
-        echo "  health             Get health status (JSON)"
-        echo "  auth               Launch authentication (opens Chrome)"
-        echo "  ask \"question\"     Ask a question to the active notebook"
-        echo "  notebooks          List available notebooks"
-        echo ""
-        echo "Examples:"
-        echo "  $0 start"
-        echo "  $0 ask \"What is the main topic?\" my-notebook"
-        echo "  $0 status"
-        ;;
-esac
+#!/bin/bash
+# NotebookLM MCP HTTP Server - WSL Helper Script
+# This script helps interact with the Windows-hosted MCP server from WSL
+#
+# Usage:
+#   ./mcp-wsl-helper.sh start          Start the server (Windows)
+#   ./mcp-wsl-helper.sh stop           Stop the server
+#   ./mcp-wsl-helper.sh status         Check if server is running
+#   ./mcp-wsl-helper.sh health         Get health status
+#   ./mcp-wsl-helper.sh ask "question" Ask a question to the active notebook
+#   ./mcp-wsl-helper.sh auth           Launch authentication (opens Chrome)
+
+set -e
+
+MCP_PORT=3000
+MCP_DIR="D:/path/to/notebooklm-mcp"
+
+# Helper function to call the API via PowerShell (bypasses WSL network issues)
+call_api() {
+    local method="$1"
+    local endpoint="$2"
+    local body="$3"
+
+    if [ -n "$body" ]; then
+        powershell.exe -Command "Invoke-RestMethod -Uri 'http://localhost:${MCP_PORT}${endpoint}' -Method ${method} -ContentType 'application/json' -Body '${body}' | ConvertTo-Json -Depth 10" 2>&1
+    else
+        powershell.exe -Command "Invoke-RestMethod -Uri 'http://localhost:${MCP_PORT}${endpoint}' -Method ${method} | ConvertTo-Json -Depth 10" 2>&1
+    fi
+}
+
+# Check if server is running
+is_running() {
+    cmd.exe /c "netstat -ano | findstr :${MCP_PORT} | findstr LISTENING" >/dev/null 2>&1
+}
+
+# Get server PID
+get_pid() {
+    cmd.exe /c "netstat -ano | findstr :${MCP_PORT} | findstr LISTENING" 2>/dev/null | awk '{print $5}' | tr -d '\r'
+}
+
+case "$1" in
+    start)
+        if is_running; then
+            echo "Server already running (PID: $(get_pid))"
+            exit 0
+        fi
+        echo "Starting NotebookLM MCP HTTP Server..."
+        powershell.exe -Command "Start-Process -NoNewWindow -FilePath 'node' -ArgumentList '${MCP_DIR}/dist/http-wrapper.js' -WorkingDirectory '${MCP_DIR}'" 2>&1
+        sleep 3
+        if is_running; then
+            echo "Server started successfully (PID: $(get_pid))"
+            echo "Health: http://localhost:${MCP_PORT}/health"
+        else
+            echo "Failed to start server"
+            exit 1
+        fi
+        ;;
+
+    stop)
+        if ! is_running; then
+            echo "Server not running"
+            exit 0
+        fi
+        PID=$(get_pid)
+        echo "Stopping server (PID: ${PID})..."
+        cmd.exe /c "taskkill /PID ${PID} /F" 2>&1
+        echo "Server stopped"
+        ;;
+
+    status)
+        if is_running; then
+            echo "Server is RUNNING (PID: $(get_pid))"
+            echo ""
+            call_api "GET" "/health"
+        else
+            echo "Server is STOPPED"
+            exit 1
+        fi
+        ;;
+
+    health)
+        if ! is_running; then
+            echo '{"success":false,"error":"Server not running"}'
+            exit 1
+        fi
+        call_api "GET" "/health"
+        ;;
+
+    auth)
+        if ! is_running; then
+            echo "Server not running. Start it first with: $0 start"
+            exit 1
+        fi
+        echo "Launching authentication (Chrome will open)..."
+        call_api "POST" "/setup-auth" '{"show_browser": true}'
+        ;;
+
+    ask)
+        if [ -z "$2" ]; then
+            echo "Usage: $0 ask \"your question here\" [notebook_id]"
+            exit 1
+        fi
+        if ! is_running; then
+            echo '{"success":false,"error":"Server not running"}'
+            exit 1
+        fi
+        QUESTION="$2"
+        NOTEBOOK_ID="${3:-}"
+
+        if [ -n "$NOTEBOOK_ID" ]; then
+            BODY="{\"question\": \"${QUESTION}\", \"notebook_id\": \"${NOTEBOOK_ID}\"}"
+        else
+            BODY="{\"question\": \"${QUESTION}\"}"
+        fi
+
+        call_api "POST" "/ask" "$BODY"
+        ;;
+
+    notebooks)
+        if ! is_running; then
+            echo '{"success":false,"error":"Server not running"}'
+            exit 1
+        fi
+        call_api "GET" "/notebooks"
+        ;;
+
+    *)
+        echo "NotebookLM MCP HTTP Server - WSL Helper"
+        echo ""
+        echo "Usage: $0 <command> [args]"
+        echo ""
+        echo "Commands:"
+        echo "  start              Start the server (Windows background process)"
+        echo "  stop               Stop the server"
+        echo "  status             Check server status and health"
+        echo "  health             Get health status (JSON)"
+        echo "  auth               Launch authentication (opens Chrome)"
+        echo "  ask \"question\"     Ask a question to the active notebook"
+        echo "  notebooks          List available notebooks"
+        echo ""
+        echo "Examples:"
+        echo "  $0 start"
+        echo "  $0 ask \"What is the main topic?\" my-notebook"
+        echo "  $0 status"
+        ;;
+esac

package/scripts/start-server-hidden.vbs

@@ -1,13 +1,16 @@
-' NotebookLM MCP Server - Démarrage silencieux
-' Lance le serveur HTTP sans fenêtre visible
-' Pour démarrage automatique : ajouter au dossier Démarrage Windows
+' NotebookLM MCP Server - hidden startup helper
+' Starts the HTTP server without opening a visible console window.
 
-Set WshShell = CreateObject("WScript.Shell")
-WshShell.CurrentDirectory = "D:\Claude\notebooklm-mcp-http"
+Dim fso
+Dim shell
+Dim scriptDir
+Dim projectDir
 
-' Définir les variables d'environnement
-Set WshEnv = WshShell.Environment("Process")
-WshEnv("DATA_DIR") = "C:\Users\romai\AppData\Local\notebooklm-mcp\Data"
+Set fso = CreateObject("Scripting.FileSystemObject")
+Set shell = CreateObject("WScript.Shell")
 
-' Lancer le serveur en mode caché (0 = hidden)
-WshShell.Run "node dist/http-wrapper.js", 0, False
+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(