如何把 Open Notebook 接入 Claude Desktop配置 MCP 服务器直接查询你的研究资料【免费下载链接】open-notebookAn Open Source implementation of Notebook LM with more flexibility and features项目地址: https://gitcode.com/GitHub_Trending/op/open-notebook如果你已经部署了一套 Open Notebook开源版 Notebook LM 实现想在 Claude Desktop 里直接检索自己的笔记本、研究资料并发起对话可以借助 Open Notebook 提供的 MCPModel Context Protocol服务器完成接入。MCP 是一个让 AI 应用安全连接外部数据源和工具的标准协议接入后你可以不离开 Claude Desktop 就列出笔记本、搜索研究内容、管理笔记和会话。本文的操作依据是项目文档 docs/5-CONFIGURATION/mcp-integration.md配合 docs/1-INSTALLATION/docker-compose.md 和 docs/5-CONFIGURATION/security.md 中的实例验证与密码保护说明。准备条件确认 Open Notebook 实例可访问MCP 服务器通过环境变量OPEN_NOTEBOOK_URL指向你的 Open Notebook API本地部署的默认地址是http://localhost:5055。在配置 Claude Desktop 之前先确认实例已启动且 API 健康检查通过。如果实例是通过 Docker Compose 启动的启动与验证命令为docker compose up -d等待 15–20 秒后执行健康检查curl http://localhost:5055/health # 文档给出的预期返回{status: healthy}注意区分两个端口8502是前端界面5055是 REST APIMCP 连接使用的是 5055。是否启用了密码保护配置中的OPEN_NOTEBOOK_PASSWORD是可选的只有在你启用了密码保护设置了OPEN_NOTEBOOK_PASSWORD环境变量时才需要填写。按照 docs/5-CONFIGURATION/security.md 的说明在未设置OPEN_NOTEBOOK_PASSWORD时认证是完全禁用的本地单机开发可以跳过密码。如果你通过 Docker 部署并启用了密码需要在 compose 环境或环境文件中设置# docker.env OPEN_NOTEBOOK_PASSWORDyour_secure_password启用后所有 API 端点如/api/notebooks都需要携带Authorization: Bearer your_password请求头而/health、/docs、/openapi.json无需认证。配置 Claude DesktopMCP 服务器发布在 PyPI包名open-notebook-mcp文档明确说明无需手动安装Claude Desktop 会通过uvx自动运行它。你只需编辑 Claude Desktop 的配置文件。macOS/Linux编辑~/Library/Application Support/Claude/claude_desktop_config.jsonWindows编辑%APPDATA%\Claude\claude_desktop_config.json文件内容如下{ mcpServers: { open-notebook: { command: uvx, args: [open-notebook-mcp], env: { OPEN_NOTEBOOK_URL: http://localhost:5055, OPEN_NOTEBOOK_PASSWORD: your_password_here } } } }两个环境变量的含义OPEN_NOTEBOOK_URL你的 Open Notebook API 地址默认http://localhost:5055OPEN_NOTEBOOK_PASSWORD可选仅当启用了密码保护时需要。其中your_password_here需要替换为你实际设置的OPEN_NOTEBOOK_PASSWORD值如果实例未启用密码保护可不填该项。连接远程服务器时的配置如果 Open Notebook 实例运行在另一台机器上按文档示例修改OPEN_NOTEBOOK_URLOPEN_NOTEBOOK_URL: http://192.168.1.100:5055如果使用域名文档给出的示例为OPEN_NOTEBOOK_URL: https://notebook.yourdomain.com/api上述值均为文档中的示例值需替换为你的实际地址。文档同时提醒连接远程服务器时要确认 5055 端口从你的机器可访问并在必要时检查防火墙设置。重启并验证连接保存配置后重启 Claude Desktop然后在对话中直接询问例如List all my notebooksSearch my research notebooks for information about [topic]What sources do I have in my [notebook name] notebook?MCP 服务器暴露的能力包括笔记本列出/详情/创建/更新/删除、资料源列出/详情/添加链接、文件、文本/更新/删除、笔记列出/详情/创建/更新/删除、聊天创建会话/发消息/获取历史/列出会话、搜索向量搜索、文本搜索、按笔记本过滤、模型与设置管理。验证时建议从列出所有笔记本这类只读查询开始能正常返回你实例中的笔记本列表即说明连接成功。连接失败时按顺序排查文档在 Troubleshooting 一节给出了连接错误的排查项确认OPEN_NOTEBOOK_URL正确且可访问本地可用curl http://localhost:5055/health验证返回{status: healthy}如果启用了密码保护确认OPEN_NOTEBOOK_PASSWORD设置正确远程服务器场景下确认 5055 端口从你的机器可以访问连接远程服务器时检查防火墙设置。边界与补充该 MCP 服务器遵循标准 MCP 协议文档说明它也可以配合任何 MCP 兼容客户端使用例如 VS Code 的 Cline 等扩展配置写入.vscode/mcp.json结构同上但键名为servers。本文以 Claude Desktop 为主路径。密码保护提供的是基础访问控制密码以明文传输、全实例共用一个密码、无速率限制文档建议在可公网访问的部署中配合 HTTPS 与强密码使用参见 docs/5-CONFIGURATION/security.md。服务器由 Epochal 团队维护包可通过 PyPI 检索open-notebook-mcp获取详见 docs/5-CONFIGURATION/mcp-integration.md 的 Finding the Server 一节。【免费下载链接】open-notebookAn Open Source implementation of Notebook LM with more flexibility and features项目地址: https://gitcode.com/GitHub_Trending/op/open-notebook创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
