← 返回目录
N

NotebookLM MCP Server

社区
通过真实的Chrome浏览器驱动NotebookLM,为AI智能体提供基于引用的知识库问答。
GitHub 源仓库 ↗
★ 3.4k Stars 分类 · 浏览器自动化 非常热门 源版本 50b3e7f67f85
55FMRS · C
可靠性
6/20
安全与权限
10/20
维护活跃度
9/20
文档质量
17/20
安装易用性
13/20

该服务器通过真实浏览器自动化提供可靠的NotebookLM集成,功能全面但依赖Chrome和Google登录,适合高级用户。

查看 FMRS 评分方法 →

notebooklm-mcp 是一个MCP服务器,用于与Google NotebookLM交互。它通过Patchright(带隐身和持久指纹)驱动真实的Chrome浏览器,使AI智能体(如Claude Code、Codex)能够直接与笔记本对话、摄取来源、生成音频概览,并读取DOM级别的引用。支持stdio和Streamable-HTTP两种传输方式。身份验证通过一次性的 setup_auth 登录后持久化,后续运行无需重复登录。支持多账户配置文件隔离。工具集包括问答、来源管理、音频生成、笔记本库管理、会话管理和系统管理。提供多种工具配置文件(minimal、standard、full)以控制上下文预算。所有回答均带有 _provenance 信封,标识AI生成内容及来源。

工具能力

ask_question
向NotebookLM笔记本提问,支持会话重用、引用提取(source_format)和每次调用的浏览器覆盖。返回答案和 _provenance 元数据。
add_source
向笔记本添加来源,支持URL抓取和文本粘贴,返回添加前后的来源数量。
generate_audio
生成音频概览(Audio Overview),可选自定义提示和超时设置。
download_audio
将最新的音频概览保存到指定目录。
add_notebook
将NotebookLM共享链接添加到本地库,需要用户确认。
list_notebooks
列出本地库中的所有笔记本及其元数据。
get_notebook
通过ID获取单个笔记本。
select_notebook
将笔记本设置为ask_question的默认活动笔记本。
update_notebook
更新笔记本的名称、描述、主题、内容类型、用例、标签或URL。
remove_notebook
从本地库移除笔记本(不会删除NotebookLM中的原始笔记本)。
search_notebooks
按名称、描述、主题、标签搜索笔记本。
get_library_stats
获取笔记本库的计数和使用统计。
list_sessions
列出当前活动的浏览器会话及其年龄和消息数。
close_session
按session_id关闭一个会话。
reset_session
重置聊天历史,同时保持相同的session_id。
get_health
返回认证状态、会话数、配置快照和故障排查提示。
setup_auth
首次交互式Google登录,弹出可见浏览器窗口,等待登录完成。
re_auth
清除存储的认证并重新登录,用于切换账户或修复认证问题。
cleanup_data
分类预览并删除所有存储的数据,可选保留library.json。

安装接入

  1. 确保已安装Node.js >= 18和Chrome浏览器。2. 全局或本地安装:npm install -g notebooklm-mcp 或使用 npx notebooklm-mcp@latest。3. 对于Claude Code:运行 claude mcp add notebooklm -- npx notebooklm-mcp@latest。4. 对于Cursor:在 ~/.cursor/mcp.json 中添加配置。5. 对于Codex:运行 codex mcp add notebooklm npx notebooklm-mcp@latest。6. 首次使用时,需要运行 setup_auth 工具完成Google登录,建议在带显示的环境或 xvfb-run 下执行。

选型与风险

适合谁

  • 需要基于用户文档的可靠问答(减少幻觉)的专业用户。
  • 已经在使用Claude Code、Cursor或Codex并希望扩展NotebookLM能力的开发者。
  • 需要自动化处理大量文档研究或内容生成的工作流。

不适合谁

  • 没有Google账户或NotebookLM访问权限的用户。
  • 无法运行Chrome浏览器或无头服务器且不能使用xvfb的用户(WSL1不支持)。
  • 需要无浏览器依赖的轻量级解决方案的用户(此服务器依赖真实Chrome)。

所需权限

  • 需要Google账户登录权限,以访问NotebookLM服务。
  • 需要运行Chrome/Chromium浏览器(通过Patchright),并可能修改其配置文件。
  • 可读写本地文件系统以存储Chrome配置文件、库数据和音频文件。
  • 可监听本地端口(HTTP模式默认3000)以提供MCP服务。
  • 可能通过网络访问NotebookLM和Google服务。

风险与副作用

  • 浏览器自动化可能触发Google的反自动化检测,导致账户受限。
  • 使用Chrome配置文件存储登录凭证(无加密),存在凭证泄露风险。
  • 第三方来源内容可能包含恶意指令,AI生成标记和声明可降低风险但不可消除。
  • 长时间运行可能导致浏览器会话累积,需关注会话超时和资源消耗。

常见排障

  1. 如果登录无法完成,确认Chrome可用,尝试在带显示的环境下运行或使用 `xvfb-run`。
  2. 如果遇到浏览器启动失败,可设置 `BROWSER_CHANNEL=chromium` 强制使用捆绑的Chromium。
  3. 检查网络连接,确保能访问Google服务。
  4. 使用 `get_health` 工具查看认证状态和配置,检查日志。
  5. 如果认证失效,运行 `re_auth` 重新登录。

使用场景

让AI智能体直接查询NotebookLM笔记本,获取有引用来源的答案。
自动化摄取网页或文本来源到笔记本。
生成音频概览并下载,用于播客或学习材料。
管理和搜索本地笔记本库,便于跨客户端共享。
在n8n、Zapier等HTTP客户端中集成NotebookLM问答。

支持客户端

Claude Code完整支持
Cursor完整支持
Codex CLI完整支持
Generic MCP client (stdio)完整支持
HTTP-only clients (n8n, Zapier)完整支持