← 返回目录
N

NotebookLM MCP Server

社区
已归档
通过真实的Chrome浏览器驱动NotebookLM,为AI智能体提供基于引用的知识库问答。
分类
浏览器自动化 第 13 / 32
Stars
★ 3.4k 非常热门
传输方式
stdio(本地进程) · Streamable HTTP
运行环境
Node.js 18+ · 预编译二进制
凭据
需要 API Key / 凭据
许可证
MIT
最近提交
工具数
19
55FMRS · C

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

最强项 · 文档质量 17/20 最弱项 · 可靠性 6/20

可靠性
6/20
安全与权限
10/20
维护活跃度
9/20
文档质量
17/20
安装易用性
13/20
查看各项评分依据
可靠性 6/20
README 声称 v2.0.0 注册了完整工具集、支持 stdio/Streamable-HTTP 和工具 profiles,内容自洽且 happy path 看似可行;但本次审查只能依赖 README,未提供实际源码、CI 工作流或提交的测试,无法验证 MCP 初始化、工具清单与实际行为是否一致。按静态校准,缺少可验证执行证据,因此可靠性不能给高;扣分主要因为无测试/CI 证据,错误处理与边界情况无法评估。
安全与权限 10/20
数据边界披露比较清楚:Chrome profile 路径按平台列出,多账户按目录隔离,且 README 明确说明没有加密的凭据存储,Google 登录 cookie 以明文 profile 保存是主要风险。setup_auth/re_auth/cleanup_data 等操作具有破坏性;add_notebook 明确要求用户确认,cleanup_data 只提到分类预览而非强制二次确认。未发现恶意代码、凭据窃取或隐蔽外传的红线行为,因此给 10 分:主要风险可见,但权限/确认/范围控制不完整。
维护活跃度 9/20
仓库未归档、MIT 许可、README 包含 npm 包、CHANGELOG 和版本迁移说明(v2.0.0 为当前版本),说明有一定维护结构和版本意识;但提供的材料中没有提交历史、发布日期、依赖更新、安全响应渠道或治理细节,40 个 open issues 也无法判断响应质量。因此按“活跃但治理/版本化存在缺口”给 9 分。
文档质量 17/20
README 是分层文档的入口:安装、认证、transport、多账户、工具表、profiles、citations、provenance、配置表、开发命令,以及 troubleshooting/usage-guide 链接都有;包含 JSON 配置示例、CLI 示例、引用输出示例和 provenance 示例,并披露了 WSL1 不支持、headless 服务器需 xvfb-run、无加密凭据存储等限制。扣分是因为链接的 docs/ 文件本身未提供,无法验证其存在与准确性,且缺少成本/配额类信息;故 17 分。
安装易用性 13/20
安装路径清晰:Node ≥18 + Chrome(或 Patchright Chromium 回退),npx 一行安装,Claude Code/Cursor/Codex/通用 MCP 的配置示例、stdio 和 HTTP 两种 transport、平台矩阵以及 headless 下 xvfb-run 的一次性认证步骤都写明。但静态校准不允许在没有真实 CI 和已提交测试证据的情况下超过 15 分;且首次认证需要可见浏览器和交互登录,存在手动/脆弱步骤,故 13 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络控制浏览器

适合谁

  • 需要基于用户文档的可靠问答(减少幻觉)的专业用户。
  • 已经在使用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生成标记和声明可降低风险但不可消除。
  • 长时间运行可能导致浏览器会话累积,需关注会话超时和资源消耗。

安装接入

准备工作

运行环境:Node.js 18+ · 预编译二进制

其他可选配置项(17 个)
HEADLESS 可选 是否无头运行 Chrome,默认 true;需要看登录窗口时可改为 false 或用 show_browser 参数。
ANSWER_TIMEOUT_MS 可选 等待 NotebookLM 回答的硬性超时,默认 600000 毫秒。
BROWSER_TIMEOUT 可选 浏览器单步操作超时,默认 30000 毫秒。
MAX_SESSIONS 可选 并发浏览器会话上限,默认 10。
SESSION_TIMEOUT 可选 会话空闲多少秒后被回收,默认 900 秒。
STEALTH_ENABLED 可选 拟人化输入/鼠标/延迟等隐匿行为的总开关,默认 true。
NOTEBOOKLM_TRANSPORT 可选 传输方式,stdio 或 http,默认 stdio。
NOTEBOOKLM_PORT 可选 HTTP 模式监听端口,默认 3000。
NOTEBOOKLM_HOST 可选 HTTP 绑定地址,默认 127.0.0.1。
NOTEBOOKLM_ACCOUNT 可选 多账号配置名,每个账号有独立的 Chrome profile 和认证状态。
NOTEBOOKLM_PROFILE 可选 工具配置档:minimal / standard / full,默认 full。
NOTEBOOKLM_DISABLED_TOOLS 可选 逗号分隔的需要禁用的工具名。
NOTEBOOKLM_AI_MARKER 可选 是否在回答前加 AI 生成标记前缀,默认 true。
NOTEBOOKLM_AI_MARKER_PREFIX 可选 自定义 AI 生成标记的文本内容。
NOTEBOOKLM_FOLLOW_UP_REMINDER 可选 是否恢复 v1 的追问提示后缀,默认关闭。
BROWSER_CHANNEL 可选 浏览器通道,设为 chromium 可强制使用内置 Patchright Chromium,默认 chrome。
NOTEBOOKLM_BROWSER_CHANNEL 可选 BROWSER_CHANNEL 的等价别名。
  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 下执行。

验证是否装好

运行 setup_auth 完成 Google 登录后,在客户端工具列表中应能看到 ask_question、list_notebooks 等工具;调用 get_health 返回认证状态和配置快照即证明连接成功。

常见排障

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

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 帮我添加这个 NotebookLM 笔记本分享链接到本地库,然后把它设为默认笔记本
  • 针对当前选中的笔记本提问:这份文档里推荐的配置步骤是什么?用脚注形式给出引用来源
  • 用 https://example.com/docs 这个网页作为新来源添加到笔记本里
  • 为这个笔记本生成一个音频概述并下载到我的下载目录

工具能力 19

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的默认活动笔记本。
展开其余 11 个工具
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。

使用场景

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

支持客户端

Claude Code
Cursor
Codex
Generic MCP client
HTTP-only clients

依据项目文档列出,未经本站实测。

详细介绍

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

同类可选方案

源版本 00179986ff6d 数据同步于 2026-10-12 查看 FMRS 评分方法