NotebookLLM MCP服务器
](https://pepy.tech/projects/notebookllm-mcp) 用于Jupyter笔记本的模型上下文协议服务器(.ipynb 文件）以一种对大型语言模型（LLM）高效的方式。它将笔记本转换为简化的纯文本格式，以减少令牌的使用和成本，并可以将其转换回来。
可用工具
load_notebook：加载a.ipynb将文件存入内存。
- 参数: - filepath （string）：指向的绝对路径 .ipynb 文件。 - 退货：（string）成功或失败消息，包括单元格计数。
notebook_to_plain_text：转换a.ipynb文件（加载或从路径）转换为简化的纯文本表示。
- 参数: - input_filepath （string，可选）：指向的绝对路径 .ipynb 文件进行即时转换。 - 退货：（string）纯文本表示或错误消息。
plain_text_to_notebook_file：将纯文本内容转换回.ipynb文件并保存。
- 参数: - plain_text_content （string）：要转换的纯文本内容。 - output_filepath （string）：保存的绝对路径 .ipynb 文件（必须以结尾 .ipynb). - 退货：（string）成功或失败消息。
add_code_cell_to_loaded_notebook：将新的代码单元格添加到当前加载的笔记本中。
- 参数: - code_content （string）：新单元格的源代码。 - position （整数，可选）：插入单元格的位置（如果 null). - 退货：（string）成功或失败消息和当前单元格计数。
add_markdown_cell_to_loaded_notebook：将新的标记单元格添加到当前加载的笔记本中。
- 参数: - markdown_content （string）：新单元格的Markdown内容。 - position （整数，可选）：插入单元格的位置（如果 null). - 退货：（string）成功或失败消息和当前单元格计数。
save_loaded_notebook：将当前加载的笔记本保存到文件。
- 参数: - output_filepath （字符串，可选）：保存的绝对路径 .ipynb 文件（必须以结尾 .ipynb).如果满足以下条件，则保存到原始路径 null. - 退货：（string）成功或失败消息。
安装
使用紫外线（推荐）
使用时 uv，不需要特定的安装。我们将使用 uvx 直接运行 notebookllm_mcp.
使用PIP
或者，您可以安装 notebookllm_mcp 通过pip：
pip install notebookllm-mcp安装后，您可以使用以下命令将其作为脚本运行：
python -m notebookllm_mcp配置
为Claude.app进行配置
添加到您的Claude设置中：
使用uvx
{
"mcpServers": {
"notebookllm": {
"command": "uvx",
"args": ["notebookllm_mcp"]
}
}
}使用pip安装
{
"mcpServers": {
"notebookllm": {
"command": "python",
"args": ["-m", "notebookllm_mcp"]
}
}
}为Zed配置
添加到您的Zed settings.json:
使用uvx
"context_servers": [
"notebookllm": {
"command": "uvx",
"args": ["notebookllm_mcp"]
}
],使用pip安装
"context_servers": {
"notebookllm": {
"command": "python",
"args": ["-m", "notebookllm_mcp"]
}
},配置VS代码
为了快速安装，请使用下面的一键安装按钮之一。..
对于手动安装，请将以下JSON块添加到VS Code中的用户设置（JSON）文件中。您可以按 Ctrl + Shift + P （或 Cmd + Shift + P 在macOS上）和键入 Preferences: Open User Settings (JSON).
您可以选择将其添加到名为的文件中 .vscode/mcp.json 在您的工作空间中。这将允许您与他人共享配置。
请注意mcp使用时需要密钥mcp.json文件。
使用uvx
{
"mcp": {
"servers": {
"notebookllm": {
"command": "uvx",
"args": ["notebookllm_mcp"]
}
}
}
}使用pip安装
{
"mcp": {
"servers": {
"notebookllm": {
"command": "python",
"args": ["-m", "notebookllm_mcp"]
}
}
}
}交互示例
- 加载笔记本：
{
"name": "load_notebook",
"arguments": {
"filepath": "/path/to/your/notebook.ipynb"
}
}答复：
{
"message": "Notebook /path/to/your/notebook.ipynb loaded successfully. Cell count: 10"
}- 将加载的笔记本转换为纯文本：
{
"name": "notebook_to_plain_text",
"arguments": {}
}答复：
# CELL 1 CODE
print("Hello World")
# CELL 2 MARKDOWN
This is a markdown cell.
...- 将纯文本转换回笔记本文件：
{
"name": "plain_text_to_notebook_file",
"arguments": {
"plain_text_content": "# CELL 1 CODE\nprint(\"Hello Again\")\n\n# CELL 2 MARKDOWN\nAnother markdown cell.",
"output_filepath": "/path/to/your/new_notebook.ipynb"
}
}答复：
{
"message": "Notebook saved to /path/to/your/new_notebook.ipynb"
}调试
您可以使用MCP检查器调试服务器。对于 uvx 安装：
npx @modelcontextprotocol/inspector uvx notebookllm_mcp或者，如果您已通过pip安装了该软件包：
npx @modelcontextprotocol/inspector python -m notebookllm_mcp构建
此软件包通常通过pip安装或直接与 uvx如果你正在开发这个包，你可以使用标准的Python构建工具来构建它。
python -m build贡献
欢迎投稿！请随时提交bug修复、新功能或文档改进的拉取请求。
许可证
该项目根据MIT许可证获得许可。