麦普服务器-朱伯特

核心功能

产品定位

mcp-server-jupyter 是一个专门用于管理和操作 Jupyter 笔记本的 MCP 服务器，旨在通过编程增强 Jupyter 笔记本的交互性和自动化能力。

主要特性

1. 读取笔记本内容：

   • 读取包含单元格输出的笔记本内容（read_notebook_with_outputs）
   • 仅读取笔记本源代码（read_notebook_source_only）
   • 读取特定单元格的输出（read_output_of_cell）

2. 编辑笔记本：

   • 添加新单元格（add_cell）
   • 修改现有单元格内容（edit_cell）

3. 执行单元格：

   • 执行特定单元格并返回其输出（execute_cell）

使用场景

• 自动化 Jupyter 笔记本操作
• 批量处理笔记本内容
• 将 Jupyter 笔记本集成到其他工作流程中
• 程序化修改和验证笔记本内容

工具列表

1. read_notebook_with_outputs：读取包含单元格输出的笔记本内容
2. read_notebook_source_only：仅读取笔记本源代码，适用于受限大小的场景
3. read_output_of_cell：读取特定单元格的输出
4. add_cell：向笔记本添加新单元格，支持代码和 Markdown 类型
5. edit_cell：修改现有单元格内容
6. execute_cell：执行特定单元格并返回其输出以进行验证

常见问题解答

• 修改后需要手动重新加载笔记本页面
• 使用工具时必须提供完整的笔记本路径
• 在操作期间 JupyterLab/Jupyter Notebook 实例必须保持运行状态

教程

依赖项

1. 安装 uv 工具
2. 创建 Python 虚拟环境

uv venv --seed
source .venv/bin/activate

安装指南

1. 安装 JupyterLab

uv pip install jupyterlab

2. 启动 JupyterLab

.venv/bin/jupyter lab

3. 获取虚拟环境路径（用于 MCP 服务器配置）

echo $(pwd)/.venv

调试

1. 配置 Claude Desktop 配置文件

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "Jupyter-notebook-manager": {
      "command": "uv",
      "args": ["run", "--with", "mcp-server-jupyter", "mcp-server-jupyter"],
      "env": {
        "UV_PROJECT_ENVIRONMENT": "/path/to/venv_for_jupyter/.venv"
      }
    }
  }
}

2. 在 Claude Desktop 聊天中使用工具时始终提供完整的笔记本路径
3. 修改后手动重新加载笔记本页面