ipynb-mcp-server 是一个 MCP 服务器,让任何 AI 智能体都能安全地读取、编辑和运行本地 Jupyter notebook,无需任何设置。它面向学生、数据从业者、教师,以及任何让智能体处理真实文件的人。该服务器通过比较并交换(compare-and-swap)锚点、原子写入和滚动备份提供安全编辑,因此编辑不会悄悄损坏 notebook。它还支持仅运行目标单元格,并提供 resume 或 replay 模式,避免重新执行耗时很长的单元格。该服务器无需 JupyterLab、端口和令牌;它是直接与 Jupyter 内核通信的 stdio 服务器。其他功能包括过期单元格分析、以原生 MCP 图像块形式输出图像、带轮询的后台执行,以及按 notebook 管理内核生命周期。
学生用 ipynb-mcp 让 AI 智能体读取课程 notebook、编写并运行单元格,带锚点的编辑如果与手动编辑发生竞争就会明确失败。
教师用 ipynb-mcp 让智能体读取每位学生单元格的输出,并通过带锚点的原子写入和滚动备份编辑作业。
任何让智能体处理真实文件的人用 ipynb-mcp 确保智能体能证明自己没有损坏 notebook。
用户可以通过 mode='resume' 或 mode='replay' 运行长时间任务,而无需重新运行耗费资源的单元格。
用户无需搭建 JupyterLab、管理令牌或保持服务器运行;该服务器是只需一行配置的 stdio 进程。
用户可以通过过期单元格分析,找出哪些输出因输入变化而失效。