@pan-sec/notebooklm-mcp 2026.1.5 → 2026.1.7

package/dist/tools/annotations.js

@@ -0,0 +1,480 @@
+/**
+ * Tool Annotations for MCP UX Enhancement
+ *
+ * Annotations provide hints about tool behavior to help clients make better decisions.
+ *
+ * @see https://modelcontextprotocol.io/specification/draft/2025-03-26/server/tools#annotations
+ */
+/**
+ * Tool metadata mapped to tool names
+ */
+export const toolMetadata = {
+    // ==========================================================================
+    // Core Research Tool
+    // ==========================================================================
+    ask_question: {
+        title: "Ask NotebookLM",
+        annotations: {
+            title: "Research Question",
+            readOnlyHint: true, // Doesn't modify data, just queries
+            destructiveHint: false,
+            idempotentHint: false, // Same question may get different answers
+            openWorldHint: true, // Interacts with external NotebookLM
+        },
+    },
+    // ==========================================================================
+    // Notebook Management
+    // ==========================================================================
+    add_notebook: {
+        title: "Add Notebook",
+        annotations: {
+            title: "Add Notebook to Library",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true, // Adding same notebook twice is safe
+            openWorldHint: false, // Local library operation
+        },
+    },
+    list_notebooks: {
+        title: "List Notebooks",
+        annotations: {
+            title: "List Library Notebooks",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    get_notebook: {
+        title: "Get Notebook",
+        annotations: {
+            title: "Get Notebook Details",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    select_notebook: {
+        title: "Select Notebook",
+        annotations: {
+            title: "Set Active Notebook",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    update_notebook: {
+        title: "Update Notebook",
+        annotations: {
+            title: "Update Notebook Metadata",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    remove_notebook: {
+        title: "Remove Notebook",
+        annotations: {
+            title: "Remove from Library",
+            readOnlyHint: false,
+            destructiveHint: true, // Removes from library
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    search_notebooks: {
+        title: "Search Notebooks",
+        annotations: {
+            title: "Search Library",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    get_library_stats: {
+        title: "Library Stats",
+        annotations: {
+            title: "Get Library Statistics",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    export_library: {
+        title: "Export Library",
+        annotations: {
+            title: "Export Library Backup",
+            readOnlyHint: true, // Just exports, doesn't modify
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    create_notebook: {
+        title: "Create Notebook",
+        annotations: {
+            title: "Create NotebookLM Notebook",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false, // Creates new notebook each time
+            openWorldHint: true, // Creates in NotebookLM
+        },
+    },
+    sync_library: {
+        title: "Sync Library",
+        annotations: {
+            title: "Sync with NotebookLM",
+            readOnlyHint: false, // Can modify library
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true, // Accesses NotebookLM
+        },
+    },
+    batch_create_notebooks: {
+        title: "Batch Create",
+        annotations: {
+            title: "Batch Create Notebooks",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    },
+    // ==========================================================================
+    // Source Management
+    // ==========================================================================
+    list_sources: {
+        title: "List Sources",
+        annotations: {
+            title: "List Notebook Sources",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true, // Reads from NotebookLM
+        },
+    },
+    add_source: {
+        title: "Add Source",
+        annotations: {
+            title: "Add Source to Notebook",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    remove_source: {
+        title: "Remove Source",
+        annotations: {
+            title: "Remove Source from Notebook",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    // ==========================================================================
+    // Audio
+    // ==========================================================================
+    generate_audio_overview: {
+        title: "Generate Audio",
+        annotations: {
+            title: "Generate Audio Overview",
+            readOnlyHint: false, // Creates audio
+            destructiveHint: false,
+            idempotentHint: false, // Regenerates each time
+            openWorldHint: true,
+        },
+    },
+    get_audio_status: {
+        title: "Audio Status",
+        annotations: {
+            title: "Check Audio Generation Status",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    download_audio: {
+        title: "Download Audio",
+        annotations: {
+            title: "Download Audio File",
+            readOnlyHint: true, // Just downloads, doesn't modify source
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    // ==========================================================================
+    // Session Management
+    // ==========================================================================
+    list_sessions: {
+        title: "List Sessions",
+        annotations: {
+            title: "List Active Sessions",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    close_session: {
+        title: "Close Session",
+        annotations: {
+            title: "Close Browser Session",
+            readOnlyHint: false,
+            destructiveHint: true, // Closes session
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    reset_session: {
+        title: "Reset Session",
+        annotations: {
+            title: "Reset Session History",
+            readOnlyHint: false,
+            destructiveHint: true, // Clears history
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    // ==========================================================================
+    // System Tools
+    // ==========================================================================
+    get_health: {
+        title: "Health Check",
+        annotations: {
+            title: "Server Health Status",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    setup_auth: {
+        title: "Setup Auth",
+        annotations: {
+            title: "Setup Google Authentication",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false, // Opens browser each time
+            openWorldHint: true, // Interacts with Google
+        },
+    },
+    re_auth: {
+        title: "Re-authenticate",
+        annotations: {
+            title: "Re-authenticate with Google",
+            readOnlyHint: false,
+            destructiveHint: true, // Deletes existing auth
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    },
+    cleanup_data: {
+        title: "Cleanup Data",
+        annotations: {
+            title: "Clean MCP Data Files",
+            readOnlyHint: false,
+            destructiveHint: true, // Deletes files
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    get_quota: {
+        title: "Get Quota",
+        annotations: {
+            title: "Check Quota Status",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false, // Local unless sync=true
+        },
+    },
+    set_quota_tier: {
+        title: "Set Tier",
+        annotations: {
+            title: "Set License Tier",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    get_project_info: {
+        title: "Project Info",
+        annotations: {
+            title: "Get Project Context",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    // ==========================================================================
+    // Webhooks
+    // ==========================================================================
+    configure_webhook: {
+        title: "Configure Webhook",
+        annotations: {
+            title: "Configure Webhook Endpoint",
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    list_webhooks: {
+        title: "List Webhooks",
+        annotations: {
+            title: "List Configured Webhooks",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    test_webhook: {
+        title: "Test Webhook",
+        annotations: {
+            title: "Send Test Event",
+            readOnlyHint: true, // Doesn't modify webhook config
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true, // Sends HTTP request
+        },
+    },
+    remove_webhook: {
+        title: "Remove Webhook",
+        annotations: {
+            title: "Remove Webhook Configuration",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    // ==========================================================================
+    // Gemini Tools
+    // ==========================================================================
+    deep_research: {
+        title: "Deep Research",
+        annotations: {
+            title: "Gemini Deep Research",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false, // Results may vary
+            openWorldHint: true, // Uses Gemini API
+        },
+        execution: {
+            // Deep research can take 1-5 minutes, ideal for task-based execution
+            taskSupport: "optional",
+        },
+    },
+    gemini_query: {
+        title: "Gemini Query",
+        annotations: {
+            title: "Quick Gemini Query",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    },
+    get_research_status: {
+        title: "Research Status",
+        annotations: {
+            title: "Check Research Progress",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    upload_document: {
+        title: "Upload Document",
+        annotations: {
+            title: "Upload to Gemini",
+            readOnlyHint: false, // Uploads file
+            destructiveHint: false,
+            idempotentHint: true, // Same file = same result
+            openWorldHint: true,
+        },
+    },
+    query_document: {
+        title: "Query Document",
+        annotations: {
+            title: "Ask About Document",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    },
+    list_documents: {
+        title: "List Documents",
+        annotations: {
+            title: "List Uploaded Documents",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    delete_document: {
+        title: "Delete Document",
+        annotations: {
+            title: "Delete from Gemini",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    },
+    query_chunked_document: {
+        title: "Query Chunked Doc",
+        annotations: {
+            title: "Query Large Document",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    },
+    // ==========================================================================
+    // History
+    // ==========================================================================
+    get_query_history: {
+        title: "Query History",
+        annotations: {
+            title: "Get Query History",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    get_notebook_chat_history: {
+        title: "Chat History",
+        annotations: {
+            title: "Get Notebook Chat History",
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true, // Reads from NotebookLM
+        },
+    },
+};
+/**
+ * Get metadata for a tool by name
+ */
+export function getToolMetadata(toolName) {
+    return toolMetadata[toolName];
+}
+//# sourceMappingURL=annotations.js.map

package/dist/tools/annotations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.js","sourceRoot":"","sources":["../../src/tools/annotations.ts"],"names":[],"mappings":"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"}

package/dist/tools/definitions.d.ts

@@ -1,12 +1,16 @@
 /**
  * MCP Tool Definitions
  *
- * Aggregates tool definitions from sub-modules.
+ * Aggregates tool definitions from sub-modules and applies
+ * enhanced metadata (icons, annotations, titles) for better UX.
+ *
+ * @see https://modelcontextprotocol.io/specification/draft/2025-03-26/server/tools
  */
 import { Tool } from "@modelcontextprotocol/sdk/types.js";
 import { NotebookLibrary } from "../library/notebook-library.js";
 /**
  * Build Tool Definitions with NotebookLibrary context
+ * Includes enhanced metadata (icons, annotations, titles) for better UX
  */
 export declare function buildToolDefinitions(library: NotebookLibrary): Tool[];
 //# sourceMappingURL=definitions.d.ts.map

package/dist/tools/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAYjE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,EAAE,CAgBrE"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAkCjE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,EAAE,CAoBrE"}

package/dist/tools/definitions.js

@@ -1,7 +1,10 @@
 /**
  * MCP Tool Definitions
  *
- * Aggregates tool definitions from sub-modules.
+ * Aggregates tool definitions from sub-modules and applies
+ * enhanced metadata (icons, annotations, titles) for better UX.
+ *
+ * @see https://modelcontextprotocol.io/specification/draft/2025-03-26/server/tools
  */
 import { askQuestionTool, buildAskQuestionDescription, } from "./definitions/ask-question.js";
 import { notebookManagementTools } from "./definitions/notebook-management.js";
@@ -10,8 +13,29 @@ import { systemTools } from "./definitions/system.js";
 import { geminiTools } from "./definitions/gemini.js";
 import { queryHistoryTools } from "./definitions/query-history.js";
 import { chatHistoryTools } from "./definitions/chat-history.js";
+import { getToolIcons } from "./icons.js";
+import { getToolMetadata } from "./annotations.js";
+/**
+ * Apply enhanced metadata (icons, annotations, title, execution) to a tool
+ */
+function enhanceTool(tool) {
+    const icons = getToolIcons(tool.name);
+    const metadata = getToolMetadata(tool.name);
+    return {
+        ...tool,
+        // Add icons if available
+        ...(icons && { icons }),
+        // Add title if available (human-friendly name)
+        ...(metadata?.title && { title: metadata.title }),
+        // Add annotations if available (behavior hints)
+        ...(metadata?.annotations && { annotations: metadata.annotations }),
+        // Add execution hints if available (e.g., task support)
+        ...(metadata?.execution && { execution: metadata.execution }),
+    };
+}
 /**
  * Build Tool Definitions with NotebookLibrary context
+ * Includes enhanced metadata (icons, annotations, titles) for better UX
  */
 export function buildToolDefinitions(library) {
     // Update the description for ask_question based on the library state
@@ -19,7 +43,8 @@ export function buildToolDefinitions(library) {
         ...askQuestionTool,
         description: buildAskQuestionDescription(library),
     };
-    return [
+    // Aggregate all tools
+    const allTools = [
         dynamicAskQuestionTool,
         ...notebookManagementTools,
         ...sessionManagementTools,
@@ -28,5 +53,7 @@ export function buildToolDefinitions(library) {
         ...queryHistoryTools,
         ...chatHistoryTools,
     ];
+    // Apply enhanced metadata to all tools
+    return allTools.map(enhanceTool);
 }
 //# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EACL,eAAe,EACf,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,qEAAqE;IACrE,MAAM,sBAAsB,GAAG;QAC7B,GAAG,eAAe;QAClB,WAAW,EAAE,2BAA2B,CAAC,OAAO,CAAC;KAClD,CAAC;IAEF,OAAO;QACL,sBAAsB;QACtB,GAAG,uBAAuB;QAC1B,GAAG,sBAAsB;QACzB,GAAG,WAAW;QACd,GAAG,WAAW;QACd,GAAG,iBAAiB;QACpB,GAAG,gBAAgB;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EACL,eAAe,EACf,2BAA2B,GAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,SAAS,WAAW,CAAC,IAAU;IAC7B,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5C,OAAO;QACL,GAAG,IAAI;QACP,yBAAyB;QACzB,GAAG,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC;QACvB,+CAA+C;QAC/C,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjD,gDAAgD;QAChD,GAAG,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;QACnE,wDAAwD;QACxD,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAwB;IAC3D,qEAAqE;IACrE,MAAM,sBAAsB,GAAG;QAC7B,GAAG,eAAe;QAClB,WAAW,EAAE,2BAA2B,CAAC,OAAO,CAAC;KAClD,CAAC;IAEF,sBAAsB;IACtB,MAAM,QAAQ,GAAW;QACvB,sBAAsB;QACtB,GAAG,uBAAuB;QAC1B,GAAG,sBAAsB;QACzB,GAAG,WAAW;QACd,GAAG,WAAW;QACd,GAAG,iBAAiB;QACpB,GAAG,gBAAgB;KACpB,CAAC;IAEF,uCAAuC;IACvC,OAAO,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACnC,CAAC"}

package/dist/tools/icons.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Tool Icons for MCP UX Enhancement
+ *
+ * Icons are defined as SVG data URIs for cross-platform compatibility.
+ * Uses simple, recognizable icons that work in both light and dark themes.
+ *
+ * @see https://modelcontextprotocol.io/specification/draft/2025-03-26/server/tools#icons
+ */
+import type { Icon } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Tool icons mapped to tool names
+ */
+export declare const toolIcons: Record<string, Icon[]>;
+/**
+ * Get icons for a tool by name
+ */
+export declare function getToolIcons(toolName: string): Icon[] | undefined;
+//# sourceMappingURL=icons.d.ts.map

package/dist/tools/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/tools/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA6F/D;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CA6D5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,SAAS,CAEjE"}