Jupyter笔记本编辑工具

Jupyter笔记本编辑器MCP服务器

一个模型上下文协议（MCP）服务器，用于以编程方式编辑Jupyter笔记本，同时保留其格式和结构。

特性

• 29种专用工具 用于笔记本电脑操作
• 基于文件的操作 -不需要Jupyter服务器
• 格式保存 -修改后的自动验证
• 批量操作 -一次修改多个单元格或笔记本
• 类型安全 -所有操作的完整类型提示

安装

一键安装

来自PyPI

uv tool install jupyter-editor-mcp
jupyter-editor-mcp

来源

git clone https://github.com/jsamuel1/jupyter-editor-mcp.git
cd jupyter-editor-mcp
uv venv
uv pip install -e ".[dev]"

看 安装.md 了解详细的配置选项。

用法

使用克劳德桌面

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "jupyter-editor": {
      "command": "jupyter-editor-mcp"
    }
  }
}

交互示例

阅读笔记本：

"Show me the structure of my notebook.ipynb"

插入单元格：

"Add a markdown cell at the beginning explaining what this notebook does"

批量操作：

"Replace all occurrences of 'old_function' with 'new_function' in all code cells"

多笔记本电脑：

"Merge analysis.ipynb and visualization.ipynb into combined.ipynb"

工具类别

• 读取操作 （4个工具）：read_notebook、list_cell、get_cell、search_cell
• 细胞修饰 （5个工具）：replace_cell、insert_cell、append_cell、delete_cell、str_replace_in_cell
• 元数据操作 （4个工具）：获取元数据、更新元数据、set_kernel、list_available_kernels
• 批量操作-多单元 （6个工具）：replace_cells_batch、delete_cells_batch、insert_cells_batch、search_replace_all、reorder_cell、filter_cells
• 批量操作-多笔记本 （7个工具）：合并笔记本、拆分笔记本、应用到笔记本、搜索笔记本、同步元数据、提取单元格、清除输出
• 验证 （3个工具）：validate_notebook、get_notebook_info、validate_notebooks_batch

发展

# Run tests
pytest

# Run tests with coverage
pytest --cov

# Install in development mode
uv pip install -e ".[dev]"

文档

• docs/RESEARCH.md -技术研究和工具规格
• 文档/要求.md -用户故事和接受标准
• docs/DESIGN.md -架构和API设计
• 贡献.md -贡献指南

许可证

麻省理工学院