AI导哈

文档问答API

基于Gemini文件搜索API的文档问答服务，支持多格式文件上传并提供精确引用的回答。

  • by mcpware
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 mcpware/notebooklm-api

使用说明

@mcpware/notebooklmapi

NotebookLM-质量文件问答-但通过MCP，由官方Gemini文件搜索API提供支持。

你上传你的文件。你问一个问题。答案中的每一句话都引用了你档案中的确切段落。没有幻觉，没有猜测，没有“我认为文件上说……”。只是带收据的接地回答。

问题

每个现有的NotebookLM MCP服务器都对谷歌的内部web UI进行逆向工程。他们用Playwright抓取页面，窃取Cookie，并祈祷谷歌不要更改CSS选择器。剧透：谷歌改变了一切。你的MCP坏了。您的Google帐户被标记。

这一个使用官方的Gemini文件搜索API。它不会刮任何东西。它不需要你的谷歌登录。仅来自的API密钥 aistudio.google.com.

你得到了什么

上传PDF、DOCX、TXT、HTML或任何 支持80多种格式。在一个或多个文档存储中提问。得到这样的答案：

The maximum liability is limited to the total fees paid
in the preceding twelve months [1]. Clients must pay all
invoices within forty-five days of receipt [2].

---
Citations:
[1] Contract_A.pdf: "The maximum liability under this agreement
    shall not exceed the total fees paid in the preceding
    twelve (12) months." (confidence: 92%)
[2] Contract_A.pdf: "The Client shall pay all invoices within
    forty-five (45) days of receipt." (confidence: 88%)

每 [1], [2] 映射到文档中的确切段落。不是总结。实际文本。

快速开始

# Set your Gemini API key
export GEMINI_API_KEY=your-key-from-aistudio.google.com

# Add to Claude Code
claude mcp add notebooklm-api npx @mcpware/notebooklm-api

# Or add to Claude Desktop (~/.claude/mcp.json)
{
  "mcpServers": {
    "notebooklm-api": {
      "command": "npx",
      "args": ["@mcpware/notebooklm-api"],
      "env": { "GEMINI_API_KEY": "your-key" }
    }
  }
}

那就自然地和克劳德谈谈。三步工作流程：

第一步：创建店铺 （每个主题一次）

“创建一个名为‘Legal Docs’的商店”

第二步：上传文件 （每个主题一次）

“将~/contracts/中的所有PDF文件上传到法律文件存储区”

第三步：提问 （你想要多少就多少）

“所有合同中的责任条款是什么？” “哪份合同的终止通知期最短？” “有合同提到竞业禁止吗？”

克劳德打电话来 create_store, upload_document，以及 ask 自动。您不需要知道商店名称或API详细信息。每个商店都是独立的，因此您可以为不同的主题（法律文件、税务记录、研究论文等）拥有单独的商店，并单独或一起查询它们。

工具

工具 它做什么
create_store 创建文档存储
list_stores 列出所有商店
upload_document 将文件（PDF、DOCX、TXT等）上传到商店。等待索引完成。
list_documents 列出商店中的文档
ask 问一个问题。返回每段引文的答案。
delete_document 删除文档
delete_store 删除商店

引文是如何工作的

当你打电话的时候 ask，Gemini文件搜索API做了三件事：

  1. 在上传的文档中搜索相关段落（向量相似性，而不是关键字匹配）
  2. 根据这些段落生成答案
  3. 退货 groundingSupports --精确源文答案中每个句子的对应图

我们将该映射解析为内联 [1], [2] 标记和引用列表。这是每个竞争对手都会出错的部分-他们在没有解析的情况下转储原始API响应。我们为您提供了一些您可以实际阅读和验证的内容。

为什么不直接使用NotebookLM？

如果web UI适合你，你应该这样做。此工具适用于以下情况：

  • 在您的编码代理（Claude Code、Cursor等）中记录问答
  • 程序化访问——上传100个文档，提出50个问题，提取结构化数据
  • 稳定性——无浏览器自动化、无Cookie、无抓取
  • 您自己的API密钥-您控制成本和数据

隐私

在免费套餐中，谷歌可能会使用您的数据来改进产品。在付费层（链接计费帐户）上，它们没有。如果您的文档是敏感的，请使用付费层。 详情.

获取API密钥

  1. 首选 aistudio.google.com
  2. 点击“获取API密钥”
  3. 设置为 GEMINI_API_KEY

免费版让你有足够的时间尝试一切。生产使用付费层。

许可证

麻省理工学院

相关 MCP