Jupyter交互MCP服务器

一个MCP服务器,允许任何兼容MCP的LLM客户端(如Claude Desktop、Claude Code等)完全控制实时JupyterLab实例。

  • by tsundokum
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 tsundokum/jupyterlab-mcp

使用说明

jupyter交互式mcp

一个MCP服务器,它使任何兼容MCP的LLM客户端(Claude Desktop、Claude Code等)能够完全控制实时JupyterLab实例。

快速开始

# Zero-install run via uvx (recommended)
uvx jupyter-interactive-mcp

# Or install permanently
pip install jupyter-interactive-mcp

Claude桌面配置

{
  "mcpServers": {
    "jupyter": {
      "command": "uvx",
      "args": ["jupyter-interactive-mcp"],
      "env": {
        "JUPYTER_URL": "http://localhost:8888",
        "JUPYTER_TOKEN": "<token>"
      }
    }
  }
}

环境变量

变量 默认值 描述
JUPYTER_URL http://localhost:8888 Jupyter服务器的基本URL
JUPYTER_TOKEN “” 身份验证令牌(来自 jupyter server --no-browser)

可用工具

  • list_notebooks --列出全部 .ipynb 文件
  • get_notebook_info --细胞计数、内核名称/状态
  • read_notebook --所有具有源和输出的单元
  • read_cell --单电池源和输出
  • edit_cell --更新单元格源(清除输出,保存)
  • add_cell --在索引处插入新单元格
  • delete_cell --删除单元格
  • run_cell --在内核中执行一个单元格,返回文本/图像
  • restart_kernel --重新启动笔记本内核
  • interrupt_kernel --中断正在运行的内核
  • get_kernel_status --空闲/繁忙/启动状态