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 -贡献指南
许可证
麻省理工学院