hucompany

主要功能

Related MCP server: NotebookLM MCP Server

重要声明

此 MCP 使用以下 内部 API：

• 未编写文档，且可能随时更改，恕不另行通知。

• 需要从浏览器中提取 Cookie。

请仅用于个人/实验目的。

安装方法

您可以使用偏好的 Python 包管理器（uv、pip、pipx 等）从 PyPI 安装 notebooklm-mcp-server。

也支持直接从源代码安装。

更新方法

请使用包管理器的升级命令更新到最新版本。

更新后，需要重启 AI 工具以刷新连接：

• Claude Code： 重启应用程序，或使用重新连接命令

• Cursor： 重启应用程序

• Gemini CLI： 重启 CLI 会话

卸载方法

要完全卸载 MCP，请使用包管理器的卸载命令。也可以选择性地从缓存的认证令牌或 AI 工具的配置文件中移除。

认证

使用 MCP 之前，需要先完成 NotebookLM 认证。

推荐使用自动模式。运行专用的 Chrome 配置文件并登录 Google 后，Cookie 会自动提取。登录信息会被保存，用于日后刷新认证。

如果自动模式无法正常工作，也可以通过文件模式在 Chrome 开发者工具中手动提取并保存 Cookie。

认证成功后，请将 MCP 添加到 AI 工具并重新启动。

有关详细信息和问题排查方法，请参阅 **docs/AUTHENTICATION.md**。

MCP 配置

⚠️ 上下文窗口（Context Window）注意： 此 MCP 提供了 31 个工具，可能会占用大量上下文窗口。在不积极使用 NotebookLM 时，建议禁用 MCP，为其他任务腾出上下文空间。

CLI 选项

可以使用命令行参数配置服务器。可以设置传输协议（stdio、http、sse）、端口、主机、调试模式、查询超时等。

环境变量

也可以通过环境变量进行配置。（NOTEBOOKLM_MCP_TRANSPORT、NOTEBOOKLM_MCP_PORT 等）

连接 AI 工具（Claude Code、Gemini CLI、IDE 等）

Claude Code、Gemini CLI 等工具可以通过内置命令轻松添加 MCP 服务器。

对于 Cursor、VS Code、Claude Desktop 等使用 JSON 配置文件的工具，需要找到已安装的 notebooklm-mcp 的路径，并将其添加到配置文件中的 mcpServers 条目中。

使用示例

您可以用自然语言与 Claude Code、Cursor、Gemini CLI 等 AI 工具对话，按以下方式使用。

调研与探索

• “列出我所有的 NotebookLM 笔记本”

• “创建一个名为‘AI 战略研究’的新笔记本”

• “针对‘企业 AI ROI 指标’启动网络调研，并展示找到的来源”

• “对‘云市场趋势’进行深度调研，并导入排名前 10 的来源”

• “在 Google Drive 中搜索与‘产品路线图’相关的文档，并创建笔记本”

添加内容

• “将这个 URL 添加到我的笔记本：https://example.com/article”

• “把这个关于 Kubernetes 的 YouTube 视频添加到笔记本中”

• “将我的会议笔记作为文本来源添加到这个笔记本中”

• “把这个 Google 文档导入我的研究笔记本”

AI 分析

• “这个笔记本的核心发现是什么？”

• “总结所有这些来源的主要论点”

• “这个来源在安全最佳实践方面是怎么说的？”

• “用 AI 总结一下这个笔记本的主题内容”

• “将聊天设置改为学习指南风格，并把回复设得更长”

生成内容

• “把这个笔记本制作为深度分析格式的音频播客概览”

• “以经典视觉风格生成视频解说”

• “基于这些来源制作简报文档”

• “制作学习用闪卡，难度设为中等”

• “生成横向信息图”

• “用我的研究来源绘制思维导图”

• “用这个笔记本制作演示幻灯片组”

智能管理

• “检查需要更新的 Google Drive 来源并进行同步”

• “显示这个笔记本的所有来源及其最新状态”

• “从笔记本中删除这个来源”

• “查看我的音频概览生成状态”

认证生命周期

• Cookie： 约保持 2~4 周（如果存在已保存的配置文件，可通过无头 Chrome 自动刷新）

• CSRF 令牌： 约保持数分钟（请求失败时自动刷新）

• 会话 ID： 每个 MCP 会话保持（MCP 启动时自动提取）

v0.1.9+：服务器会自动处理令牌过期。

1. 过期时立即刷新 CSRF 令牌

2. 如果从外部更新过，则从磁盘重新加载 Cookie

3. 如果存在已保存的登录配置文件，则通过无头 Chrome 执行认证

如果自动刷新失败（Google 登录完全过期），则需要重新运行认证工具。

问题排查

更新未正确生效时

由于包管理器的缓存问题或版本限制，可能无法安装最新版本。此时可以使用强制重装选项来解决。

Chrome DevTools MCP 无法正常工作时（Cursor/Gemini CLI）

如果 Chrome DevTools MCP 显示为“无工具”或无法启动，可能是已知的 npx 错误。这种情况下，将配置改为使用 pnpm 运行即可解决。

限制

• 速率限制： 免费套餐每天约限 50 次查询。

• 无官方支持： API 可能随时更改，恕不另行通知。

• Cookie 过期： 可能需要每隔几周重新提取一次 Cookie。

参与贡献

有关 API 文档及如何添加新功能，请参阅 CLAUDE.md。

许可证

MIT License