内容
# notebooklm-mcp
MCP（模型上下文协议）服务器，将[谷歌笔记本LM](https://notebooklm.google.com)作为Claude Desktop、Claude Code及任何其他MCP兼容客户端的工具界面。
构建在[notebooklm-py](https://github.com/teng-lin/notebooklm-py)的基础上，一个非官方的笔记本LM Python API。
> **警告 — 非官方/未文档化的API**
>
> `notebooklm-py`驱动谷歌内部的笔记本LM端点，这些端点**未文档化，可能随时更改**。谷歌与该项目无关。API可能会随时中断。
>
> **建议：使用一个临时谷歌账户**进行此集成，而不是您的主要账户。速率限制和服务条款限制适用。
---
## 可用工具
| 工具 | 描述 |
|------|-------------|
| `notebooklm_list_notebooks` | 列出账户中的所有笔记本 |
| `notebooklm_create_notebook` | 创建一个新的笔记本 |
| `notebooklm_add_source` | 添加一个URL、YouTube链接或粘贴的文本作为源 |
| `notebooklm_ask` | 在笔记本的源中提问 |
| `notebooklm_generate_audio_overview` | 生成音频概述（播客深度解析） |
| `notebooklm_list_artifacts` | 列出笔记本中生成的所有工件 |
| `notebooklm_download_artifact` | 下载工件到本地文件 |
---
## 安装和设置
### 1. 安装软件包
**选项A — uvx（推荐，不需要持久安装）：**
```bash
# 无需安装步骤；uvx按需下载和运行。
# 只需确保uv已安装：https://docs.astral.sh/uv/
```
**选项B — pip到专用环境：**
```bash
pip install "notebooklm-mcp"
```
**选项C — 从源代码（此仓库）：**
```bash
git clone https://github.com/deji-adesoga/notebooklm-mcp
cd notebooklm-mcp
python -m venv .venv
.venv\Scripts\activate # Windows
# source .venv/bin/activate # macOS/Linux
pip install -e .
```
### 2. 安装Chromium浏览器（登录所需）
```bash
playwright install chromium
```
如果在Linux上看到`TypeError: onExit is not a function`，请参阅[notebooklm-py故障排除指南](https://github.com/teng-lin/notebooklm-py/blob/main/docs/troubleshooting.md#linux)。
### 3. 身份验证（一次性）
```bash
notebooklm login
```
这将打开一个Chromium浏览器窗口。使用您的（临时）谷歌账户登录。凭证保存在`~/.notebooklm/profiles/default/storage_state.json`中。您只需要执行此操作一次 — MCP服务器会自动读取存储的cookie。
要验证身份验证是否成功：
```bash
notebooklm auth check --test
```
---
## Claude Desktop配置（Windows MSIX）
Claude Desktop的MSIX版本从以下位置读取其MCP配置：
```
%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json
```
打开该文件（如果不存在，请创建它）并在`mcpServers`对象中添加`notebooklm`条目。
### 选项A — uvx（无需持久安装）
```json
{
"mcpServers": {
"notebooklm": {
"command": "uvx",
"args": ["notebooklm-mcp"]
}
}
}
```
### 选项B — 本地venv（从源代码安装）
```json
{
"mcpServers": {
"notebooklm": {
"command": "C:\\Users\\Diggity\\Documents\\Local Repositories\\notebooklm-mcp\\.venv\\Scripts\\python.exe",
"args": ["-m", "notebooklm_mcp.server"]
}
}
}
```
在编辑配置后重启Claude Desktop。
---
## 快速入门（配置完成后）
服务器运行时，Claude可以使用自然语言驱动笔记本LM：
```
列出我的笔记本。
创建一个名为“AI安全阅读清单”的笔记本。
添加https://arxiv.org/abs/2301.13379作为源，并等待它被索引。
在该笔记本中提问“关键发现是什么？”。
为笔记本生成音频概述。
将音频下载到C:/Users/Diggity/Downloads/podcast.mp3。
```
---
## 工件类型参考
调用`notebooklm_download_artifact`时，请使用以下`artifact_type`值：
| artifact_type | 输出格式 |
|---------------|---------------|
| `audio` | MP3/MP4 |
| `video` | MP4 |
| `report` | Markdown (.md) |
| `quiz` | JSON |
| `flashcards` | JSON |
| `infographic` | PNG |
| `slide_deck` | PDF |
| `data_table` | CSV |
| `mind_map` | JSON |
---
## 开发
```bash
git clone https://github.com/deji-adesoga/notebooklm-mcp
cd notebooklm-mcp
python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
# 验证工具枚举清晰（无需谷歌登录）
python -c "from notebooklm_mcp.server import mcp; print([t.name for t in mcp.get_tools().values()])"
# 使用MCP Inspector测试
npx @modelcontextprotocol/inspector python -m notebooklm_mcp.server
```
---
## 许可证
MIT — 请参阅[LICENSE](LICENSE)。
底层库：[notebooklm-py](https://github.com/teng-lin/notebooklm-py)（MIT）。
