内容
# 笔记本LM连接器
[](https://notebooklmconnector.vercel.app) [](https://pypi.org/project/notebooklm-connector/) [](LICENSE)
**🌐 网站： [notebooklmconnector.vercel.app](https://notebooklmconnector.vercel.app)**
将您的 **谷歌笔记本LM** 笔记本带入 **任何支持MCP的AI助手** — Claude、Cursor、Codex、Antigravity IDE、Cline等。询问只有您的来源才能回答的问题（附带引用），添加来源，并生成音频概述、报告、测验等 — 所有这些都来自正常的聊天。
## 安装
在下面选择您的应用程序。然后在聊天中说 **“连接我的笔记本LM”**，选择您的谷歌账户，然后您就连接成功了 — 永远不需要密码。
> **一次性要求：** 连接器需要 **Python 3.12** 和 **[uv](https://docs.astral.sh/uv/)** 在您的机器上。
> Mac：`brew install python@3.12 uv` · Windows：[python.org](https://www.python.org/downloads/) + [uv安装](https://docs.astral.sh/uv/getting-started/installation/).
> *(Claude Desktop的`.mcpb`只需要Python — 其运行时提供其他所需内容。)*
### Claude Desktop — 下载并双击
**[⬇️ 下载NotebookLM-Connector.mcpb](https://github.com/asimhafeezz/notebooklm-connector/releases/latest)** → 双击它 → **安装**。完成。
### Cursor — 一键安装
[](https://cursor.com/install-mcp?name=notebooklm&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLXB5dGhvbiIsIjMuMTIiLCJub3RlYm9va2xtLWNvbm5lY3RvciJdfQ==)
### Codex — 一行命令
```bash
codex mcp add notebooklm -- uvx --python 3.12 notebooklm-connector
```
### Claude Code — 一行命令
```bash
claude mcp add notebooklm -- uvx --python 3.12 notebooklm-connector
```
### 谷歌Antigravity
在代理侧边栏中：**⋯ → MCP服务器 → 管理MCP服务器 → 查看原始配置**，然后添加以下条目。（配置文件：`~/.gemini/config/mcp_config.json`。）
```json
{
"mcpServers": {
"notebooklm": { "command": "uvx", "args": ["--python", "3.12", "notebooklm-connector"] }
}
}
```
### 任何其他MCP客户端（Antigravity IDE、Cline等）
将上面显示的相同`mcpServers`条目添加到客户端的MCP配置中。
所有非Claude Desktop选项都运行相同的命令， **`uvx --python 3.12 notebooklm-connector`**，它从PyPI获取连接器 — 无需克隆。（ `--python 3.12`是必需的 — 依赖项没有针对Python 3.13的预编译轮。）
> **故障排除“连接已关闭”/服务器无法启动：**
> - **最常见：** 确保命令包含 `--python 3.12`（上文）。如果没有，它将尝试在Python 3.13上编译失败。
> - **“命令未找到”：** 您的应用程序无法在PATH上找到`uvx`。使用完整路径代替 — 使用 `which uvx` 查找（例如 `/opt/homebrew/bin/uvx`）并使用该路径作为 `command`。
## 您可以询问
- *“询问我的论文笔记本：来源讨论了哪些反驳意见？”*
- *“创建一个名为‘竞争者研究’的笔记本，并添加这三个URL作为来源。”*
- *“为我的入职笔记本制作一个关于部署的音频概述，然后保存到我的桌面。”*
- *“给我一个生物学笔记本的测验。”*
- *“给我一个关于身份验证流程的 **详细** 答案。”* — 打开自动覆盖（下文）。
这背后有 **13种工具**：连接/登录、列出和创建笔记本、添加来源（URL、YouTube、文本、文件）、询问带有引用的问题、生成和下载工作室内容（音频、视频、报告、测验、闪存卡、思维导图、幻灯片、信息图表、数据表）。
## 详细模式（自动覆盖）
询问 *“详细”* 或 *“完整”* 答案时，连接器运行 **自动覆盖**：在第一个答案后，它询问笔记本LM哪些部分的问题没有得到充分涵盖，自动询问这些后续问题，并返回一个合并的、更完整的答案 — 所有这些仍然引用您的来源。
默认情况下关闭（它使用每日配额的几个额外查询）。在问题中打开它（“给我一个详细的答案”），或通过在服务器的环境中设置 `NOTEBOOKLM_THOROUGH=1` 始终打开。 使用 `NOTEBOOKLM_MAX_FOLLOWUPS` 调整深度（默认为 3）。
## 需要注意的事项
- **无需密码** — 连接器重用您已经在浏览器中登录的谷歌账户。在Mac上，请批准一次性钥匙串弹出窗口。
- **会话持续约2-4周。** 当它停止工作时，只需说“连接我的笔记本LM”即可。
- **免费笔记本LM账户** 每天允许大约50个问题。
- **这是您自己的账户** — 像正常使用一样使用它。
- **非官方** — 此使用笔记本LM的内部API（谷歌没有公共API）。它可靠但如果谷歌更改内容可能会中断；更新通常会修复它。
## 浏览器和操作系统
连接器通过读取浏览器中现有的谷歌会话登录。哪些浏览器有效取决于您的操作系统：
| 浏览器 | macOS | Windows | Linux | 备注 |
|---|:---:|:---:|:---:|---|
| Chrome, Brave, Edge, Chromium | ✅ | ✅ | ✅ | 最容易 — 一个钥匙串/OS提示 |
| Firefox, LibreWolf, Zen | ✅ | ✅ | ✅ | |
| Opera, Vivaldi | ✅ | ✅ | ✅ | |
| Arc | ✅ | ✅ | — | Linux上不可用 |
| **Comet** (Perplexity) | ✅ | — | — | 仅限macOS |
| Safari | ✅ | — | — | 需要macOS **完全磁盘访问权限** |
| **Atlas** (OpenAI), 以及其他 *应用程序绑定加密* 浏览器 | ❌ | ❌ | ❌ | Cookie被锁定到应用程序 — 无法读取（见下文） |
> 在 **macOS** 上开发和全面测试。 上述跨平台浏览器在Windows/Linux上也有效（通过 [rookiepy](https://github.com/thewh1teagle/rookie)）；Comet和Safari仅限macOS。
**在Linux（Ubuntu等）上：** Chrome/Chromium/Brave/Edge/Firefox都有效。Chromium将其cookie密钥存储在 **GNOME Keyring** 或 **KWallet** （Linux等效于macOS钥匙串）中，连接器从中读取。如果没有密钥环或在无头框中，Chromium使用其无密钥环的“基本”存储 — 它仍然有效，无需秘密提示。 如果由于任何原因无法读取浏览器，则在所有操作系统上都有效。
**它使用哪个浏览器？** 默认情况下，它尝试 **Chrome** — 它 **不** 读取您的操作系统的默认浏览器设置。 以普通语言告诉它使用哪个浏览器（ *“使用Brave连接”* ， *“使用Comet连接”* ）并使用该浏览器代替。
**我们无法读取的浏览器（Atlas或其他未列出的浏览器）？** 一些浏览器（像OpenAI的Atlas）用锁定到应用程序本身的密钥加密cookie — 一种刻意的反恶意软件保护，阻止所有外部读取器，包括此连接器。对于这些： 在任何支持的浏览器（Chrome/Brave/Firefox/Comet）中登录 [notebooklm.google.com](https://notebooklm.google.com) 并 *“使用Brave连接”* ，或使用交互式登录窗口（ `uv sync --extra interactive-login && uv run playwright install chromium` ，然后 *“交互式登录”* ）无论您的日常浏览器如何。
## 工作原理
`notebooklm-connector` （此项目）是 **MCP服务器** — 您的AI助手与之通信并添加13种工具、详细模式和登录的部分。 它 *使用* [notebooklm-py](https://github.com/teng-lin/notebooklm-py)，一个与笔记本LM内部API通信的库，来与谷歌实际通信。 授权是您的浏览器的现有谷歌会话，在您的本地机器上读取。 除了发送到笔记本LM本身之外，任何内容都不被发送到任何地方 — 它完全在您的计算机上运行。
## 安全性和隐私
此连接器通过读取浏览器的现有谷歌会话cookie登录 — 与您已经登录的方式相同。以下是其具体含义。
**它访问**
- 您的浏览器的cookie加密密钥，从macOS **钥匙串** （您一次性批准此操作），仅用于解密cookie。
- 您的浏览器的 **cookie数据库** ，过滤到 **谷歌/笔记本LM域** — 而不是您的其他网站。
- 它将您的会话写入 `~/.notebooklm/` （仅限所有者， `chmod 600` ）以便它不必每次都重新读取浏览器。
**它不执行**
- ❌ 它从不将您的cookie或数据发送到 **笔记本LM自己的服务器** （ `notebooklm.google.com` ）以外的任何地方 — 您的浏览器已经将它们发送到同一个地方。
- ❌ 没有遥测，没有分析，没有第三方服务器。 它完全在您的机器上运行。
- ❌ 它不触及非谷歌cookie，密码或其他钥匙串项目。
**这是恶意软件使用的技术吗？** 读取浏览器cookie在机械上与恶意软件infostealer的作用相同 — 因此值得询问。 区别在于它周围的所有内容：此操作 **在本地运行，得到您的明确同意** ， **开源** （阅读代码）， **不传输任何数据** ，并且 **限定为谷歌域** 。 恶意软件的定义特征 — 将cookie发送给攻击者 — 正是此操作从未执行的操作。
**保持安全**
- **仅安装官方构建版本** — 从此存储库的 [版本](https://github.com/asimhafeezz/notebooklm-connector/releases) 或 [PyPI](https://pypi.org/project/notebooklm-connector/) 。 因为任何读取cookie的工具 *都可能* 被修改为行为不端，所以不要运行非官方副本。
- **您的会话存储在 `~/.notebooklm/` ** 作为实时谷歌身份验证 — 将该文件夹视为敏感（它已经锁定到您的用户账户）。
- **仅在需要Safari的情况下授予Safari“完全磁盘访问权限”** — 其他浏览器不需要它。
**随时撤销**
- 删除 `~/.notebooklm/` 以删除存储的会话，和/或退出谷歌（这使cookie在所有地方都失效）。
## 开发者
```bash
uv sync # 安装
uv run notebooklm-connector # 运行服务器
npx @modelcontextprotocol/inspector uv run notebooklm-connector # 交互式测试工具
npx @anthropic-ai/mcpb pack . dist/NotebookLM-Connector.mcpb # 重建.mcpb安装程序
```
包装 [notebooklm-py](https://github.com/teng-lin/notebooklm-py)。多个谷歌账户： `uv run notebooklm login --profile work` ，然后在服务器的环境中设置 `NOTEBOOKLM_PROFILE=work`。
MIT许可。
