@roomi-fields/notebooklm-mcp 1.5.9 → 1.7.0

package/dist/utils/vault-writer.js

@@ -0,0 +1,214 @@
+/**
+ * Vault writer — formats NotebookLM answers as RTFM-ingestable markdown files
+ *
+ * Each answer is written as two artifacts:
+ *   - {slug}.md   — markdown with YAML frontmatter (human + RTFM markdown parser)
+ *   - {slug}.json — structured payload conforming to nblm-answer-v1 schema
+ *
+ * Schema URL: https://schemas.roomi-fields.com/nblm-answer-v1.json
+ */
+import { promises as fs } from 'fs';
+import path from 'path';
+export const NBLM_ANSWER_SCHEMA_URL = 'https://schemas.roomi-fields.com/nblm-answer-v1.json';
+/**
+ * Slugify a question into a filesystem-safe filename component.
+ * Truncates to ~80 chars and prefixes with a zero-padded index.
+ */
+export function makeSlug(question, prefix, index) {
+    const base = question
+        .toLowerCase()
+        .normalize('NFD')
+        .replace(/[̀-ͯ]/g, '')
+        .replace(/[^a-z0-9\s-]/g, '')
+        .replace(/\s+/g, '-')
+        .replace(/-+/g, '-')
+        .substring(0, 80)
+        .replace(/-+$/, '')
+        .replace(/^-+/, '');
+    const idx = String(index + 1).padStart(3, '0');
+    const cleanBase = base || 'question';
+    return prefix ? `${prefix}-${idx}-${cleanBase}` : `${idx}-${cleanBase}`;
+}
+/**
+ * Escape a string for safe use as a YAML scalar value.
+ * Wraps in double quotes and escapes backslashes + double quotes.
+ */
+function yamlString(s) {
+    return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+}
+/**
+ * Format a NotebookLM answer as a vault-ready markdown document
+ * with YAML frontmatter compatible with RTFM's markdown parser.
+ */
+export function formatAnswerMarkdown(data, notebookMeta, askedAt) {
+    const citations = data.sources?.citations ?? [];
+    const sourceNames = Array.from(new Set(citations.map((c) => c.sourceName).filter((s) => Boolean(s))));
+    const frontmatterLines = ['---'];
+    frontmatterLines.push(`title: ${yamlString(data.question)}`);
+    frontmatterLines.push(`type: nblm-answer`);
+    frontmatterLines.push(`asked_at: ${askedAt}`);
+    if (notebookMeta.id)
+        frontmatterLines.push(`notebook_id: ${yamlString(notebookMeta.id)}`);
+    if (notebookMeta.name)
+        frontmatterLines.push(`notebook_name: ${yamlString(notebookMeta.name)}`);
+    if (notebookMeta.url || data.notebook_url) {
+        frontmatterLines.push(`notebook_url: ${yamlString(notebookMeta.url ?? data.notebook_url)}`);
+    }
+    if (data.session_id)
+        frontmatterLines.push(`session_id: ${yamlString(data.session_id)}`);
+    frontmatterLines.push(`citations_count: ${citations.length}`);
+    if (sourceNames.length > 0) {
+        frontmatterLines.push('sources:');
+        for (const name of sourceNames) {
+            frontmatterLines.push(`  - ${yamlString(name)}`);
+        }
+    }
+    frontmatterLines.push('---');
+    const sourcesBlock = citations.length > 0
+        ? '\n\n## Sources\n\n' +
+            citations
+                .map((c) => {
+                const name = c.sourceName ?? 'Unknown source';
+                const text = (c.sourceText ?? '').trim();
+                const quoted = text ? text.replace(/\r?\n/g, '\n> ') : '_(no excerpt)_';
+                return `### [${c.number}] ${name}\n\n> ${quoted}`;
+            })
+                .join('\n\n')
+        : '';
+    const notebookLink = notebookMeta.url || data.notebook_url
+        ? `\n\n> Asked on ${askedAt} against [${notebookMeta.name ?? 'NotebookLM notebook'}](${notebookMeta.url ?? data.notebook_url})`
+        : '';
+    return `${frontmatterLines.join('\n')}
+
+# ${data.question}${notebookLink}
+
+## Answer
+
+${data.answer}${sourcesBlock}
+`;
+}
+/**
+ * Build the structured JSON payload (sidecar) for a NotebookLM answer.
+ * Conforms to nblm-answer-v1 schema.
+ */
+export function formatAnswerJson(data, notebookMeta, askedAt) {
+    const citations = data.sources?.citations ?? [];
+    const sourceNames = Array.from(new Set(citations.map((c) => c.sourceName).filter((s) => Boolean(s))));
+    return {
+        $schema: NBLM_ANSWER_SCHEMA_URL,
+        type: 'nblm-answer',
+        version: '1.0',
+        asked_at: askedAt,
+        session_id: data.session_id ?? null,
+        notebook: {
+            id: notebookMeta.id ?? null,
+            name: notebookMeta.name ?? null,
+            url: notebookMeta.url ?? data.notebook_url ?? null,
+        },
+        question: data.question,
+        answer: {
+            text: data.answer,
+            format: 'markdown',
+        },
+        citations: citations.map((c) => ({
+            marker: c.marker,
+            number: c.number,
+            source_name: c.sourceName ?? null,
+            source_text: c.sourceText ?? null,
+        })),
+        metadata: {
+            tags: [],
+            extraction_success: data.sources?.extraction_success ?? null,
+            citations_count: citations.length,
+            source_names: sourceNames,
+        },
+    };
+}
+/**
+ * Run a batch of questions and persist each answer as `{slug}.md` + `{slug}.json`
+ * in `vault_dir`. Shared between the HTTP `/batch-to-vault` endpoint and the
+ * `batch_to_vault` MCP tool — the only difference between callers is the
+ * `askQuestion` function passed in (both wrap `ToolHandlers.handleAskQuestion`).
+ */
+export async function runBatchToVault(args, askQuestion, logger) {
+    const { questions, vault_dir, notebook_id, notebook_url, slug_prefix = '', source_format = 'json', sleep_between_ms = 0, session_id, } = args;
+    const absVaultDir = path.resolve(vault_dir);
+    await fs.mkdir(absVaultDir, { recursive: true });
+    const results = [];
+    let currentSession = session_id;
+    const notebookMeta = {};
+    for (let i = 0; i < questions.length; i++) {
+        const q = questions[i];
+        logger?.info?.(`[${i + 1}/${questions.length}] ${String(q).substring(0, 80)}`);
+        try {
+            const askResult = await askQuestion({
+                question: q,
+                session_id: currentSession,
+                notebook_id,
+                notebook_url,
+                source_format,
+            });
+            if (!askResult?.success || !askResult.data || askResult.data.status !== 'success') {
+                const errMsg = askResult?.error ||
+                    (askResult?.data && 'error' in askResult.data ? askResult.data.error : 'Unknown error');
+                results.push({
+                    question: q,
+                    md_path: '',
+                    json_path: '',
+                    success: false,
+                    citations_count: 0,
+                    error: errMsg,
+                });
+                continue;
+            }
+            const data = askResult.data;
+            if (data.session_id)
+                currentSession = data.session_id;
+            if (!notebookMeta.url && data.notebook_url)
+                notebookMeta.url = data.notebook_url;
+            if (!notebookMeta.id && notebook_id)
+                notebookMeta.id = notebook_id;
+            const askedAt = new Date().toISOString();
+            const slug = makeSlug(q, slug_prefix, i);
+            const mdPath = path.join(absVaultDir, `${slug}.md`);
+            const jsonPath = path.join(absVaultDir, `${slug}.json`);
+            const markdown = formatAnswerMarkdown(data, notebookMeta, askedAt);
+            const jsonPayload = formatAnswerJson(data, notebookMeta, askedAt);
+            await fs.writeFile(mdPath, markdown, 'utf-8');
+            await fs.writeFile(jsonPath, JSON.stringify(jsonPayload, null, 2), 'utf-8');
+            results.push({
+                question: q,
+                md_path: mdPath,
+                json_path: jsonPath,
+                success: true,
+                citations_count: data.sources?.citations.length ?? 0,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger?.error?.(`[${i + 1}] failed: ${msg}`);
+            results.push({
+                question: q,
+                md_path: '',
+                json_path: '',
+                success: false,
+                citations_count: 0,
+                error: msg,
+            });
+        }
+        if (sleep_between_ms > 0 && i < questions.length - 1) {
+            await new Promise((r) => setTimeout(r, sleep_between_ms));
+        }
+    }
+    const succeeded = results.filter((r) => r.success).length;
+    return {
+        vault_dir: absVaultDir,
+        total: questions.length,
+        succeeded,
+        failed: questions.length - succeeded,
+        session_id: currentSession,
+        notebook: notebookMeta,
+        files: results,
+    };
+}
+//# sourceMappingURL=vault-writer.js.map

package/dist/utils/vault-writer.js.map

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

package/docs/MCP_DIRECTORIES.md

@@ -0,0 +1,84 @@
+# MCP Directories & Registries
+
+Tracking of all directories where `@roomi-fields/notebooklm-mcp` is listed or submitted.
+
+## Currently Listed
+
+| Directory                 | URL                                                                                                              | Notes                                                                                          |
+| ------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
+| **Glama.ai**              | [glama.ai/mcp/servers/@roomi-fields/notebooklm-mcp](https://glama.ai/mcp/servers/@roomi-fields/notebooklm-mcp)   | Security A, Quality A, License A. Auto-indexed.                                                |
+| **PulseMCP**              | [pulsemcp.com/servers/pleaseprompto-notebooklm](https://www.pulsemcp.com/servers/pleaseprompto-notebooklm)       | #163 global, ~177k visitors. Auto-aggregated.                                                  |
+| **mcpservers.org**        | [mcpservers.org/servers/roomi-fields/notebooklm-mcp](https://mcpservers.org/servers/roomi-fields/notebooklm-mcp) | Full listing. Auto-indexed.                                                                    |
+| **MCPMarket.com**         | [mcpmarket.com/server/notebooklm](https://mcpmarket.com/server/notebooklm)                                       | Has Top 100 leaderboard.                                                                       |
+| **LobeHub**               | [lobehub.com/mcp/roomi-fields-notebooklm-mcp](https://lobehub.com/mcp/roomi-fields-notebooklm-mcp)               | Auto-indexed.                                                                                  |
+| **npm**                   | [npmjs.com/package/@roomi-fields/notebooklm-mcp](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp)     | v1.5.7 published with `mcpName` field.                                                         |
+| **Official MCP Registry** | [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/)                                    | `io.github.roomi-fields/notebooklm-mcp` v1.5.7, status active.                                 |
+| **Cursor Directory**      | [cursor.directory/mcp/notebooklm-mcp](https://cursor.directory/mcp/notebooklm-mcp)                               | Submitted via web form. Live.                                                                  |
+| **awesome-mcp-servers**   | [github.com/punkpeye/awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)                       | 79.6k stars. Merged via [PR #2467](https://github.com/punkpeye/awesome-mcp-servers/pull/2467). |
+
+## Pending Review
+
+| Directory             | Submission          | Date       | Link                                                                         |
+| --------------------- | ------------------- | ---------- | ---------------------------------------------------------------------------- |
+| **Cline Marketplace** | Issue               | 2026-02-27 | [Issue #703](https://github.com/cline/mcp-marketplace/issues/703)            |
+| **mcp.so**            | Comment on Issue #1 | 2026-02-27 | [Comment](https://github.com/chatmcp/mcpso/issues/1#issuecomment-3971662494) |
+
+## Not Yet Submitted (Tier 2)
+
+| Directory                                    | How to Submit                                             | Priority |
+| -------------------------------------------- | --------------------------------------------------------- | -------- |
+| **FindMCP.dev**                              | Web form at findmcp.dev (~2 min)                          | Medium   |
+| **wong2/awesome-mcp-servers** (3.6k stars)   | GitHub PR                                                 | Medium   |
+| **appcypher/awesome-mcp-servers** (5k stars) | GitHub PR                                                 | Medium   |
+| **MCPIndex.net**                             | Contact form at mcpindex.net/en/contact                   | Medium   |
+| **MCPList.ai**                               | Web form                                                  | Medium   |
+| **Docker MCP Catalog**                       | PR on github.com/docker/mcp-registry (needs Docker image) | Medium   |
+| **Windsurf Directory**                       | windsurf.run/mcp                                          | Low      |
+
+## Not Yet Submitted (Tier 3)
+
+| Directory                                       | How to Submit                            |
+| ----------------------------------------------- | ---------------------------------------- |
+| **MCPServerFinder.com**                         | Web form                                 |
+| **MCPServer.dev**                               | Web form                                 |
+| **MCPServe.com**                                | Web form at mcpserve.com/submit          |
+| **MCP-Server-Directory.com**                    | Web form                                 |
+| **MCPServers.com**                              | Web form                                 |
+| **MCPDir.dev**                                  | Web form (open source, 8k+ servers)      |
+| **MCPServerHub.net**                            | Web form                                 |
+| **MCPServerHub.com**                            | Web form                                 |
+| **MCP-Servers-Hub.net**                         | Web form at mcp-servers-hub.net/submit   |
+| **AIAgentsList.com**                            | Web form at aiagentslist.com/mcp-servers |
+| **APITracker.io**                               | Web form at apitracker.io/mcp-servers    |
+| **ClaudeMCP.org**                               | Web form                                 |
+| **ClaudeMCP.com**                               | Web form                                 |
+| **UBOS.tech**                                   | GitHub PR                                |
+| **TensorBlock/awesome-mcp-servers** (471 stars) | GitHub PR                                |
+
+## Other Actions
+
+| Action                     | Status                                                  | Notes                                                                       |
+| -------------------------- | ------------------------------------------------------- | --------------------------------------------------------------------------- |
+| **GitHub fork detachment** | Requested via GitHub Support Virtual Agent (2026-02-27) | Detach from PleasePrompto/notebooklm-mcp. Will enable Contributors sidebar. |
+| **GitHub notifications**   | Enabled on all 13 public repos                          | Watch → All Activity                                                        |
+| **Cline logo**             | Not yet created                                         | 400x400 PNG needed for Cline Marketplace submission                         |
+
+## How to Complete Official MCP Registry
+
+```bash
+cd /mnt/d/path/to/notebooklm-mcp
+
+# 1. Login (opens browser for GitHub device flow)
+./mcp-publisher login github
+
+# 2. Publish
+./mcp-publisher publish
+
+# 3. Verify
+curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.roomi-fields/notebooklm-mcp"
+```
+
+## Files Related to Registry
+
+- `server.json` — Official MCP Registry metadata
+- `package.json` — Contains `mcpName: "io.github.roomi-fields/notebooklm-mcp"`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomi-fields/notebooklm-mcp",
-  "version": "1.5.9",
+  "version": "1.7.0",
   "mcpName": "io.github.roomi-fields/notebooklm-mcp",
   "description": "MCP server for NotebookLM API with HTTP REST API - Zero hallucinations from your notebooks",
   "type": "module",