NotebookLM代理插件
MCP服务器和代理集成套件,允许AI编码助手(Cursor、Claude Code)与 谷歌笔记本LM.
包含什么
| 组件 | 路径 | 目的 |
|---|---|---|
| MCP服务器 | mcp-server/ | Stdio MCP服务器将NotebookLM操作作为工具公开 |
| 饼干提取器 | scripts/extract_cookies.py | 从Firefox/Chrome中提取会话Cookie进行身份验证 |
| 光标挂钩 | hooks/ | MCP调用前自动刷新身份验证 |
| 光标规则 | rules/ | 指示代理将NotebookLM工作委托给子代理 |
| 光标技能 | skills/ | 教代理如何使用NotebookLM工具 |
| Claude代码配置 | CLAUDE.md | Claude Code代理说明 |
快速启动
1.安装
git clone https://github.com/amp-rh/notebooklm-agent-plugin.git
cd notebooklm-agent-plugin
./install.sh这将安装 notebooklm-mcp 通过pip命令(可编辑模式)。
2.身份验证
登录 笔记本语言模型 在Firefox或Chrome浏览器中,然后提取Cookie:
python3 scripts/extract_cookies.py \
--domains .google.com notebooklm.google.com \
--required SID OSID __Secure-OSID \
--host-filter '%notebooklm%' \
--output ~/.notebooklm/storage_state.json3.配置您的代理
光标
将MCP服务器添加到项目的 .cursor/mcp.json:
{
"mcpServers": {
"notebooklm": {
"command": "notebooklm-mcp",
"args": []
}
}
}可选增强功能 (推荐最佳体验):
- 钩子 --合并
hooks/hooks.json进入~/.cursor/hooks.json,更新指向此仓库的路径hooks/目录。auth钩子在每次NotebookLM MCP调用之前自动刷新Cookie。
- 规则 --复制
rules/notebooklm-subagent.mdc到你的项目.cursor/rules/向代理传授子代理委托模式。
- 技能 --注册
skills/notebooklm/SKILL.md在您的光标技能配置中。
克劳德代码
将MCP服务器添加到您的 .mcp.json:
{
"mcpServers": {
"notebooklm": {
"command": "notebooklm-mcp",
"args": []
}
}
}Claude Code将自动从 CLAUDE.md 此仓库中的文件。
可用工具
| 工具 | 说明 |
|---|---|
notebooklm_auth_status | 检查凭据是否存在(本地,无网络) |
notebooklm_list_notebooks | 列出所有笔记本 |
notebooklm_get_notebook | 按ID获取笔记本详细信息 |
notebooklm_create_notebook | 创建新笔记本 |
notebooklm_rename_notebook | 重命名笔记本 |
notebooklm_delete_notebook | 删除笔记本 |
notebooklm_chat | 发送消息并获得AI响应 |
notebooklm_get_chat_history | 获取对话历史记录 |
notebooklm_get_notebook_description | 获取人工智能生成的摘要和主题 |
notebooklm_open_notebook | 在默认浏览器中打开笔记本 |
身份验证详细信息
NotebookLM没有公共的API-它使用Google会话cookie进行身份验证。包括 extract_cookies.py 脚本直接从浏览器的cookie数据库中读取cookie:
- 火狐 (首选):阅读
cookies.sqlite直接(Linux上未加密) - 铬:用途 菜鸟 解密Cookie
Cursor身份验证挂钩(hooks/notebooklm-auth.sh)在每次NotebookLM MCP调用之前自动运行此提取,因此只要您的浏览器会话处于活动状态,凭据就会保持新鲜。
码头工人
在容器中构建并运行MCP服务器:
cd mcp-server
docker build -t notebooklm-mcp .运行时装载您的凭据:
docker run -i --rm -v ~/.notebooklm:/root/.notebooklm notebooklm-mcp需求
- Python 3.11+
- Linux(cookie提取直接读取浏览器数据库)
- 带有活动NotebookLM会话的Firefox或Chrome
jq(用于钩子脚本)
依赖项
许可证
Apache许可证2.0
